# SynapSeq

> SynapSeq is an open-source, text-driven audio sequencer. It renders binaural beats, monaural beats, isochronic pulses, noise, ambience, and music from plain-text SPSQ scores.

SynapSeq is available as a command-line application and as public Go packages. Use the links below as the canonical starting points for installation, syntax, programming, AI integration, and example sequences.

## Documentation

- [Installation](https://synapseq.org/docs/install): Install SynapSeq, compile from source, and run example sequences.
- [SPSQ Syntax](https://synapseq.org/docs/spsq): Complete reference for writing SPSQ scores, including tracks, effects, transitions, templates, and validation behavior.
- [Programming](https://synapseq.org/docs/programming): Overview of the public Go packages and links to their pkg.go.dev API references.
- [CLI](https://synapseq.org/docs/cli): Command-line reference for rendering, AI generation, SynapSeq Remote, tooling, and platform-specific options.
- [Documentation index](https://synapseq.org/docs): Choose the Installation, SPSQ Syntax, CLI, or Programming guide.

## Using SynapSeq

- [Get Started](https://synapseq.org/docs/install): Installation for people and coding agents, source compilation, and example scores.
- [AI](https://synapseq.org/ai): Native AI-assisted SPSQ generation through OpenAI-compatible LLM APIs. See the [AI CLI reference](https://synapseq.org/docs/cli#ai) for configuration options.
- [Curated Library](https://synapseq.org/library): Browse official SynapSeq sequences selected for the library and their source scores. SynapSeq Remote exposes the library through the CLI; see the [Remote CLI reference](https://synapseq.org/docs/cli#remote).
- [FAQ](https://synapseq.org/faq): Usage, audio methods, licensing, source audio, and project questions.

## Primary Sources

- [SynapSeq repository](https://github.com/synapseq-foundation/synapseq): Source code, releases, and contribution guidance.
- [SPSQ informal grammar](https://github.com/synapseq-foundation/synapseq/blob/main/docs/GRAMMAR.md): Compact reference for accepted SPSQ line shapes and tokens.
- [Go module](https://pkg.go.dev/github.com/synapseq-foundation/synapseq/v4): Versioned Go API documentation.

## Optional

- [Origins](https://synapseq.org/origins): Project history and SBaGen import context.
- [Community](https://synapseq.org/community): Community notes and links.