{"id":13744540,"url":"https://github.com/eegsynth/eegsynth","last_synced_at":"2025-05-15T05:07:02.821Z","repository":{"id":31096212,"uuid":"34655359","full_name":"eegsynth/eegsynth","owner":"eegsynth","description":"Converting real-time EEG into sounds, music and visual effects","archived":false,"fork":false,"pushed_at":"2025-03-08T11:28:40.000Z","size":55887,"stargazers_count":364,"open_issues_count":26,"forks_count":62,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-05-15T05:06:57.622Z","etag":null,"topics":["art-net","bci","dmx","ecg","eeg","emg","fieldtrip","midi","osc","redis","synthesizer"],"latest_commit_sha":null,"homepage":"https://www.eegsynth.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eegsynth.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-04-27T08:42:57.000Z","updated_at":"2025-04-20T23:29:31.000Z","dependencies_parsed_at":"2024-01-28T13:30:28.469Z","dependency_job_id":"4b18f3ae-efee-4796-8a52-394f3645b7e7","html_url":"https://github.com/eegsynth/eegsynth","commit_stats":{"total_commits":1623,"total_committers":12,"mean_commits":135.25,"dds":"0.16327788046826863","last_synced_commit":"18c72053270d1e80939407245d1879714a9ccc65"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eegsynth%2Feegsynth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eegsynth%2Feegsynth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eegsynth%2Feegsynth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eegsynth%2Feegsynth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eegsynth","download_url":"https://codeload.github.com/eegsynth/eegsynth/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254276447,"owners_count":22043867,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["art-net","bci","dmx","ecg","eeg","emg","fieldtrip","midi","osc","redis","synthesizer"],"created_at":"2024-08-03T05:01:11.420Z","updated_at":"2025-05-15T05:06:57.799Z","avatar_url":"https://github.com/eegsynth.png","language":"Python","funding_links":[],"categories":["Python","Software"],"sub_categories":["Python Toolboxes"],"readme":"# README\n\n![logo](doc/figures/EEGsynth_logo.svg?sanitize=true)\n\nThe EEGsynth is a [Python](https://www.python.org/) codebase released under the [GNU general public license]( https://en.wikipedia.org/wiki/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.\n\nSince December 2018, the EEGsynth is registered as a legal _Association_ with the French authorities.\n\n## Documentation\n\nThe EEGsynth code and technical documentation are hosted on [Github](https://github.com/eegsynth) and organized as follows:\n\n* [src/eegsynth](https://github.com/eegsynth/eegsynth/tree/master/src/eegsynth) contains the EEGsynth application (see below)\n* [src/module](https://github.com/eegsynth/eegsynth/tree/master/src/module) contains individual modules and reference dopcumentation\n* [src/lib](https://github.com/eegsynth/eegsynth/tree/master/src/lib) contains some libraries\n* [doc](https://github.com/eegsynth/eegsynth/tree/master/doc) contains the general documentation\n* [patches](https://github.com/eegsynth/eegsynth/tree/master/patches) contains patches and documentation of past performances\n* [hardware](https://github.com/eegsynth/eegsynth-hardware) contains documentation on some custom hardware\n\n## Installation\n\nYou can install the EEGsynth with `pip install eegsynth`. Further installation details can be found in the [documentation](https://github.com/eegsynth/eegsynth/blob/master/doc/installation.md).\n\n## Running the EEGsynth\n\nFollowing 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\n\n```console\neegsynth buffer.ini generatesignal.ini plotsignal.ini\n```\n\nor you can start it one module at a time by starting multiple terminals, each with a separate EEGsynth instance, like this\n\n```console\neegsynth buffer.ini\neegsynth generatesignal.ini \neegsynth plotsignal.ini\n```\n\nor you can start the graphical user interface (GUI) like this\n\n```console\neegsynth --gui\n```\n\nYou 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.\n\n## Disclaimer\n\nThe 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](https://opensource.com/open-source-way) and [open-hardware](https://opensource.com/resources/what-open-hardware) project that brings together programmers, musicians, artists, neuroscientists and developers in scientific and artistic exploration.\n\nAlthough there are plans to make it more 'plug-and-play', the EEGsynth currently has to be run from the command line, using [Python](https://www.python.org/) and [Bash](https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29) scripts, and is therefore not friendly for those not familiar with such an approach.\n\n## Collaborate and get more information\n\nWhen 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.\n\nMore information can be found at [our website](https://www.eegsynth.org).  Follow us on [Facebook](https://www.facebook.com/EEGsynth/) and [Twitter](https://twitter.com/eegsynth), and check our past and upcoming events on [our calendar](http://www.eegsynth.org/?calendar=eegsynth-calendar). Please feel free to contact us via our [contact form](http://www.eegsynth.org/?page_id=233).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feegsynth%2Feegsynth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feegsynth%2Feegsynth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feegsynth%2Feegsynth/lists"}