README
The EEGsynth is a Python codebase released under the GNU general public license that provides a real-time interface between (open-hardware) devices for electrophysiological recordings (e.g., EEG, EMG and ECG) and analogue and digital devices (e.g., MIDI, lights, games and analogue synthesizers). The EEGsynth allows one to use electrical activity recorded from the brain or body to flexibly control devices in real-time, like (re)active and passive brain-computer-interfaces (BCIs), biofeedback and neurofeedback.
Since December 2018, the EEGsynth is registered as a legal Association with the French authorities.
Documentation
The EEGsynth code and technical documentation are hosted on Github and organized as follows:
- src/eegsynth contains the EEGsynth application (see below)
- src/module contains individual modules and reference dopcumentation
- src/lib contains some libraries
- doc contains the general documentation
- patches contains patches and documentation of past performances
- hardware contains documentation on some custom hardware
Installation
You can install the EEGsynth with pip install eegsynth. Further installation details can be found in the documentation.
Running the EEGsynth
Following installation of the EEGsynth and starting Redis, you can start eegsynth *.ini from a terminal with all ini files contained in a patch, for example like this
eegsynth buffer.ini generatesignal.ini plotsignal.ini
or you can start it one module at a time by starting multiple terminals, each with a separate EEGsynth instance, like this
eegsynth buffer.ini
eegsynth generatesignal.ini
eegsynth plotsignal.ini
or you can start the graphical user interface (GUI) like this
eegsynth --gui
You can subsequently drag-and-drop the ini files that you want to start into the GUI. After editing an ini file, you can simply drop it into the GUI again and the module will automatically restart; there is no need to stop and restart all of them.
Disclaimer
The EEGsynth does not allow diagnostic investigations or clinical applications. It also does not provide a graphical user interface for offline analysis. Rather, the EEGsynth is intended as a collaborative interdisciplinary open-source and open-hardware project that brings together programmers, musicians, artists, neuroscientists and developers in scientific and artistic exploration.
Although there are plans to make it more 'plug-and-play', the EEGsynth currently has to be run from the command line, using Python and Bash scripts, and is therefore not friendly for those not familiar with such an approach.
Collaborate and get more information
When you start an project with the EEGsynth, consider doing it together with in a group of people that have knowledge and experience complimentary to yours, such as in electrophysiology, neuroscience, psychology, programming, computer science or signal processing.
More information can be found at our website. Follow us on Facebook and Twitter, and check our past and upcoming events on our calendar. Please feel free to contact us via our contact form.
1 maintainer
Metadata
1 maintainer
Release files for eegsynth 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| eegsynth-0.8.1.tar.gz | 179.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| eegsynth-0.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 526.8 kB
Release files / eegsynth-0.8.1.tar.gz
| Download URL | eegsynth-0.8.1.tar.gz |
|---|---|
| Size | 179.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
beae49dad6859f79915bc9599ee2f800ed8df6cacb5b0dde92a2ceec26784800
|
|
BLAKE2b-256 checksum How to use checksums |
d0c05e09b0dee36a69a63ec2598b82710dd89087b020002e0cb0201e3db37161
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 22, 2026.
Transparency logRelease files / eegsynth-0.8.1-py3-none-any.whl
| Download URL | eegsynth-0.8.1-py3-none-any.whl |
|---|---|
| Size | 347.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9639e924e6072977e739baa4460eda35e39c380806d3832ce2d02c24ad487263
|
|
BLAKE2b-256 checksum How to use checksums |
fe88a4d63ec9f0be5a3c8b95b5a784d2e1a4c41f994ae66b60e912f6fc2e64aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 22, 2026.
Transparency log
