Hosaka 2.0 (30th December 2025) Tomas Ukkonen <tomas.ukkonen@iki.fi>
====================================================================

Hosaka 2.0 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 2.0 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 2.0 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.

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 more options and 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

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

