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

Hosaka is still experimental audiovisual software that tries to modify
brainwaves (EEG). You can increase sleep (tested) 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 now Windows GUI version of the software. It can be started by clicking:

hosaka-gui.exe

To use Hosaka with mindmonitor (set computers ip address and port 4545 in mind monitor app)
you can use command:

./hosaka.exe --device=mindmonitor --concentration

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

./hosaka.exe --device=lsl --concentration
./hosaka.exe --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).

Command "./hosake.exe --help" shows information about command-line options.

You can select target state using command:

./hosaka.exe --device=mindmonitor --target=-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,1,1

To list 21 target state names you can use command (you must have EEG connection first):

./hosaka.exe --device=mindmonitor --list-targets

Or use preset targets (--concentration, --sleep, --relax).

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

./hosaka.exe --device=random

Hosaka now supports saving video stimulation into video (--save-viddeo)
but there are small problems in sound sometimes for unknown reasons (bug?).
Filename of video is neurostim.mp4.

Hosaka can also save model files to "--save=<dir>" directory. You can later
reuse the saved model files with "--load=<dir>" command (after load new models
are not computed/updated from measurements).

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 be found from
licenses.zip (contains also library licenses used in Linux).

