Chords-LSL-Visualizer#

Overview#

The Chords-LSL-Visualizer is an open-source, Rust-based graphical application for visualizing biosignals streamed over the Lab Streaming Layer (LSL) for Chords. It is designed to work seamlessly with Chords-compatible hardware (such as Neuro Playground Lite or other BioAmp devices running Chords firmware) by subscribing to their LSL streams and rendering live bio-potential signals in an interactive GUI.

With Chords-LSL-Visualizer, you can:

  • Discover available LSL streams from your connected hardware.

  • Visualize multi-channel ExG signals (EEG, EMG, ECG, etc.) in real time.

  • Apply filters to the live data for cleaner signal observation.

  • Select the number of channels you want to visualize.

  • Cross-platform compatibility: Windows, macOS, and Linux.

Chords-LSL-visualizer Landing Page

Chords-LSL-Visualizer#

What is Lab Streaming Layer (LSL)?#

Lab Streaming Layer (LSL) is an open-source protocol and software framework for real-time streaming of time-synchronized data, especially in neuroscience and biomedical experiments.

LSL is an open-source networked middleware ecosystem to stream, receive, synchronize, and record neural, physiological, and behavioral data streams acquired from diverse sensor hardware.

To know more about LSL click here.

System Requirements#

  • Operating System: Windows 10+ / macOS 10.15+ / Linux (glibc 2.27+)

  • Chords LSL Connector running LSL-enabled firmware (e.g., Neuro Playground Lite).

Hardware Requirements#

Setting up the hardware#

Make all the connections according to the hardware you are using, including sensor connections with the development board, body connections with the sensor, and connections from the development board to your laptop.

Installation#

  1. Download the installer from the latest release: Chords LSL Visualizer Release

  2. Choose the installer for your OS:

    • Fedora → .rpm

    • Debian/Ubuntu → .deb

    • macOS → .dmg

    • Windows → .msi

    • Or download the source bundle to build yourself

  3. Run the installer for your OS:

Windows (.msi)

  1. Double-click the downloaded .msi file.

  2. If you see a SmartScreen warning, click More Info → Run Anyway.

  3. Proceed through the installer wizard: Next → select install location → Install → Finish.

Fedora (.rpm)

  1. Open a terminal and run:

sudo dnf install Chords.LSL.Visualizer-0.1.0-1.x86_64.rpm

  1. Enter your password and confirm the install when prompted.

  2. After installation, launch Chords LSL Visualizer from your Applications menu.

Debian/Ubuntu (.deb)

  1. Open a terminal and run:

sudo apt install ./Chords.LSL.Visualizer_<version>_amd64.deb

  1. If you hit missing dependencies, run:

sudo apt --fix-broken install

  1. Launch Chords LSL Visualizer

chords-lsl-visualizer
macOS (.dmg)

  1. Double-click the downloaded Chords.LSL.Visualizer.<version>.dmg file.

  2. When you see the macOS warning:

  3. “Chords.LSL.Visualizer.<version>.dmg” was downloaded from the Internet.

Are you sure you want to open it?

click **Open**

  1. Drag Chords LSL Visualizer.app into your Applications folder.

  2. Eject the mounted image and open the app from Applications.

  1. (Optional) Build from source

git clone https://github.com/upsidedownlabs/Chords-LSL-Visualizer.git
cd Chords-LSL-Visualizer
npm i
cargo tauri build

Flashing the Firmware#

Visualization of LSL#

Once installed, follow these steps to start visualizing your biosignals:

  1. Start Chords-LSL-Visualizer and click Scan LSL Stream. This scans for active LSL streams broadcasted by your Chords LSL Connector or compatible firmware.

    Scan LSL Stream

  2. Click Refresh to update the list of available streams.

    Select LSL Stream

  3. Select your device from the list and hit Visualize.

    Select LSL Stream

  4. Once the stream starts, choose your filter options (e.g., 50Hz, 60Hz) according to your region.

    Apply Filters 1
    Apply Filters 2

  5. From Settings, select the number of channels you want to visualize.

    Channel Selection

  6. Begin real-time visualization of your ExG signals.

    Real-time Signal Visualisation

GitHub Repository#

For full source code, issue tracking, and contribution guidelines, head over to the Chords-LSL-Visualizer GitHub repo.

You’ll discover setup guides and can track ongoing development - including bug fixes and feature enhancements: Chords LSL Visualizer GitHub