Timeflux workshop

An interactive workshop about Timeflux, a free and open-source framework for the acquisition and real-time processing of biosignals.

Installation

Make sure you have docker (or podman) installed. If you run Windows, you might need either the Mentalab Explore-desktop app or explorepy to connect to the Mentalab headset and push the data to the Labstreaming Layer. If you use linux, this should be fully handled by the container.

I didn't come around to being able to share the build container, so you'll have to build it yourself using

git clone https://github.com/NeuroTech-Leuven/timeflux-workshop.git
docker build . -t timeflux-workshop

Usage

To run timeflux

Running timeflux with simulated data:

docker run --net=host -e DATA_SOURCE=simulated --publish-all --privileged -it localhost/timeflux-workshop:latest

Running an LSL server connected to the Mentalab headset and running timeflux

docker run --net=host -e DATA_SOURCE=lsl -e MENTALAB_NAME=<MENTALAB_NAME> --publish-all --privileged -it localhost/timeflux-workshop:latest

If you want to change and test the code without having to rebuild the container image, clone the code and run the docker command with the added option -v ./brainbrowsr:/project to mount your code changes directly into the container.

To open the BrainBrowsR example

Launch the Google Chrome/Chromium web browser with the following command-line options

chromium-browser --disable-web-security --disable-features=IsolateOrigins,site-per-process --disable-site-isolation-trials --user-data-dir=<TEMP_DATA_DIR>

to allow controlling the Facebook iframe from whithin our JS app.

The BrainBrowsr interface can be found at http://localhost:8000/brainbrowsr/, The monitoring example at http://localhost:8001/monitor/

Useful resources

• Timeflux talk
• The timeflux documentation
• The timeflux whitepaper
• Timeflux BCI implementations of the classical BCI paradigms:
• Labstreaming layer