SynapSeq

Text-Driven Audio Sequencer for Brainwave Entrainment

Build repeatable brainwave sessions and ambient listening experiences from plain-text score files. Define presets, timing, and sound layers, then render, preview, or play the result.

Get Started

How SynapSeq is Different

SynapSeq is not a DAW and not a meditation app. It is a deterministic sequencing engine for structured listening sessions.

Sessions, Not Static Tracks

Instead of editing waveforms directly, SynapSeq lets you describe presets and timeline periods in text, producing sessions that evolve predictably over time instead of static looping tracks.

Text-Based by Design

SynapSeq uses a small, human-readable text format (.spsq) so sessions can be versioned with Git, reviewed like code, shared openly, and extended without binary project files.

Deterministic & Reproducible

Same sequence, same result. SynapSeq is designed for repeatable rendering, validation, and predictable playback across research, production, and personal workflows.

CLI First, Workflow Ready

Render WAV or MP3, generate HTML previews, play directly through ffplay, validate sessions before export, and pull reusable content from the Player without leaving your workflow.

Create or Listen?

Browse ready-made sessions in the Player, or install the CLI and start building your own.

I want to listen

Open the Player

Browse curated .spsq sessions for relaxation, focus, meditation, and sleep. No install needed.

Open Player

I want to create

Install the CLI

Get SynapSeq on your machine and start building text-driven audio sessions from plain-text files.

Press and Community

SynapSeq is starting to show up across free software, Linux, and developer communities. This section highlights external coverage and notable write-ups.

Press Mention Português (Brasil)

SynapSeq - programa para estimular as ondas cerebrais

Viva o Linux featured SynapSeq for the Brazilian free software and Linux community, covering installation, the CLI workflow, first steps with .spsq files, and practical playback and export examples.

Viva o Linux March 29, 2026 Brazilian free software and Linux portal

Read article

More mentions from blogs, portals, and developer communities can be added here over time.

Frequently Asked Questions

Everything you need to know about SynapSeq

About SynapSeq

SynapSeq is a text-driven audio sequencer for building repeatable brainwave sessions and ambient listening experiences from plain-text score files. It is a CLI-first tool that lets you define structure, timing, and sound layers in a small domain-specific language and then render, preview, validate, or play the result in a reproducible way.

You can install SynapSeq easily using Winget (Windows), Homebrew (macOS/Linux), or by downloading a precompiled binary.

The latest precompiled binaries for Windows, macOS, or Linux can be found in the Get Started section.

SynapSeq sequences are now accessed directly from the CLI through the built-in Player commands. Start by refreshing the local Player index, then list or search for available sequences:

synapseq -player-update

synapseq -player-list

synapseq -player-search focus

When you find a sequence you want, inspect its metadata with -player-info, download it with -player-download, or render it directly with -player-get.

Write your session in a .spsq file using the documented syntax, then render it with:

synapseq my-sequence.spsq output.wav

You can also validate syntax with -test, generate an HTML timeline with -preview, or play directly with -play when ffplay is available:

synapseq -preview my-sequence.spsq

synapseq -play my-sequence.spsq

See the Get Started section for installation and the Player.

SynapSeq can render WAV output, export MP3 when ffmpeg is available, generate HTML previews, and play sessions directly through ffplay. It is designed for both file-based rendering and workflow-oriented previewing.

At the moment, there are no plans to develop an official Graphical User Interface (GUI) for SynapSeq. The community is free to create GUIs that use SynapSeq as their engine.

Audio Methods

Binaural beats occur when two slightly different frequencies are played in each ear. The brain perceives a third "beat" at the difference frequency, which can help entrain brainwaves to a desired state. Headphones are required for binaural beats to work.

Monaural beats are created by mixing two frequencies together before playback. The resulting beat is physically present in the audio and can be perceived without headphones, though headphones may enhance the effect.

Isochronic tones are single tones that pulse on and off at regular intervals. This rhythmic stimulation can entrain brainwaves and is effective with or without headphones.

Binaural beats: Best for deep meditation, relaxation, and creativity.
Monaural beats: Good for general entrainment, can be used without headphones.
Isochronic tones: Effective for alertness, focus, and can be used with speakers.

Binaural beats: Yes, headphones are required.
Monaural beats: Optional, but recommended for best results.
Isochronic tones: Not required.

Delta (0.5–4 Hz): Deep sleep, healing
Theta (4–8 Hz): Meditation, creativity
Alpha (8–13 Hz): Relaxed alertness, learning
Beta (13–30 Hz): Focus, active thinking
Gamma (30+ Hz): Peak concentration

For most people, entrainment-oriented audio is considered safe when used responsibly. However, some individuals (such as those with epilepsy, heart conditions, or neurological disorders) should consult a medical professional before using SynapSeq sessions or related audio methods.

General tips:

Do not use while driving or operating machinery.
Stop immediately if you feel discomfort, dizziness, or unusual sensations.
Use moderate volume and avoid excessive session lengths.
SynapSeq sessions are not a substitute for medical treatment.

Entrainment effects and perceptual responses vary from person to person. Several factors can affect your experience:

Equipment & Technical Issues:

Headphones required for binaural beats (decent quality)
Use appropriate frequencies for your goal
Avoid low-quality formats (use high-bitrate MP3 or keep WAV)
Check amplitude and volume settings

Tips for better results:

Experiment with different methods (binaural, monaural, isochronic)
Try different frequencies and durations
Combine with meditation or relaxation techniques
Be patient and approach with an open mind

No. There is no scientific evidence that SynapSeq or entrainment audio can reproduce or simulate the effects of drugs, medications, or psychoactive substances. The software can help structure sessions for relaxation, focus, meditation, sleep, and ambient listening, but it does not induce drug-like states.

Scientific research on entrainment-related audio has produced mixed results. Some studies suggest benefits for relaxation, focus, meditation, and sleep, but effects are generally modest and vary from person to person. There is no broad scientific consensus that these methods produce strong or universal outcomes.

Usage & Licensing

Yes. SynapSeq can be integrated in two main ways: either as a standalone CLI tool or as a native Go library. SynapSeq is licensed under GPL v2.

You may freely use the CLI or Go library in any project, but if you modify or distribute the SynapSeq source code itself, your changes must also be released under GPL v2.

Yes, you can sell audio tracks generated with SynapSeq. However, you are responsible for ensuring that your sequence files and any background sounds used do not infringe on third-party copyrights.

SynapSeq can generate MP3 output when ffmpeg is installed and available. WAV remains the best choice for archival quality, while MP3 is useful for distribution and lightweight sharing.

Note: MP3 is a lossy format that reduces audio quality due to compression. For archival purposes or maximum fidelity, consider keeping WAV files alongside MP3 versions. Use high bitrate (at least 320 kbps) for best results.