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).

To use Hosaka with mindmonitor (set computers ip address and port 4545 in mind monitor app),
you can just start Hosaka without command-line parameters:

./hosaka.exe

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

./hosaka.exe --device=lsl
./hosaka.exe --device=lsl --lsl-names='BA HALO 002_HALO_BrainAccess','EEG'

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

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 glitches in sound sometimes for unknown reasons (bug?).

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).

