Use EEG as audio, or use audio as EEG

This package is meant to provide a bridge between audio software, such as Ableton Live, and EEG acquisition systems and real-time EEG analysis software. The provided applications can be used to upsample an EEG data stream to a standard audio sampling rate, or to downsample an audio data stream to a rate more common for EEG. The recommended output sample rate for Ableton Live is 44100 or 48000 Hz, the typical sampling rate for EEG systems is 250 Hz.

For macOS you can use BlackHole (recommended) or SoundFlower (outdated) to create virtual audio devices.

For Windows you can use VB-Audio Cable to create virtual audio devices.

resampleaudio

This application takes an input audio stream - for example the 8000 Hz stream from the EAVI board - and resamples/upsamples and streams it to another (virtual) output audio device.

This application makes use of PortAudio and Secret Rabbit Code (aka libsamplerate).

lsl2audio

This application takes an input LSL stream, resamples/upsamples it to a standard audio rate, and streams it to a (virtual) output audio device.

audio2lsl

This application takes an input audio stream at an standard audio rate, for example from a (virtual) output audio device, resamples/downsamples it to an EEG rate and outputs it to an LSL stream.

External dependencies

http://www.portaudio.com and http://libsndfile.github.io/libsamplerate for both applications
https://labstreaminglayer.readthedocs.io for lsl2audio and audio2lsl.

You can install these with your platform-specific package manager (homebrew, apt, yum), after which they will end up in /usr/local/lib and /usr/local/include. You can also install them manually in the external directory. In that case the directory layout should be

external/
├── portaudio
│   ├── include
│   └── lib
├── samplerate
│   ├── include
│   └── lib
└── lsl
    ├── include
    └── lib

Copyrights

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

robertoostenveld / resampleaudio