Hosaka 2.01 Tomas Ukkonen <tomas.ukkonen@iki.fi>
================================================

Hosaka is still experimental audiovisual software that tries to modify
brainwaves (EEG). You can increase sleep (tested, default), concentration
or relaxation (experimental) or use your own EEG-derivative numbers target state.

Currently, effects to EEG are small but software seem to work a bit even
when a measured error increases (sleep is mostly tested).

Hosaka requires a EEG-device to measure brain which is used to optimize and 
select audiovisual stimuli which best moves brain towards the target EEG value 
(21 comma separated numbers between [0,1] or negative if value is not used)

Hosaka supports MindMonitor App (Muse EEG devices) and the LSL protocol
(BrainAccess HALO EEG and other devices).

There is also graphical user interface version of the software which can be
started by using command

hosaka-gui

To use Hosaka with mindmonitor (set computers ip address and port 4545 in mind monitor app),
use following commands:

hosaka --device=mindmonitor --concentration
hosaka --device=mindmonitor --sleep
hosaka --device=mindmonitor --relax

To use Hosaka with LSL protocol (BrainAccess HALO EEG, Emotiv EEG etc), you can use commands:

hosaka --device=lsl --concentration
hosaka --device=lsl --lsl-names='BA HALO 002_HALO_BrainAccess','EEG' --concentration

If you don't set --lsl-names the LSL code connects to the first found LSL stream.

IMPORTANT: You need to watch stimulus for 30 minutes to 2 hours for significant results
when using fast CPU (I use 32-thread AMD CPU at 5 GHz). Software reports NUM_MODEL number
which tells how many times machine learning model has already computed (you need to have
at least 1 for some results and should have more than 5).

Command "hosaka --help" shows more options and you can select target state using command:

hosaka --device=mindmonitor --target=-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,1,1

If you don't have the EEG-device, you can test software with random EEG:

hosaka --device=random --concentration

Software also logs various things to a log file "hosaka-engine.log".


LICENSE
=======

Softaware is freeware. It is free to use but closed source.
Links with non-GPL libraries. Library license files can found
from https://www.whiteclinic.net/ website.
