libYSE

libYSE is a cross-platform C++ sound engine for live, experimental electronic music: patchers, live coding, instruments and MIDI in one signal graph, with spatial and physical controllers such as positions, swarms and physics moving the sounds. It plays audio files and procedural sources at any position in a 3D scene, mixes them through a hierarchical channel tree, and applies positioned reverb zones that the listener moves through. Windows, Linux, and Android are supported.

New here? Start with What is libYSE?, then Mental model, then Hello, sound. Looking for a specific class or function? The API Reference is the full reference. Coming from 2.4? Read Upgrading from 2.4 to 3.0 first.

Get started

• What is libYSE?
  • What libYSE is
  • What libYSE is not
  • Supported platforms
  • Licence
  • Where next
• Mental model
  • System
  • Listener
  • Sound
  • Channel
  • Reverb
  • Patcher
  • Putting it together
• Threading model
  • The threads
  • Rendering
  • What update() drives
  • Rules for the host
  • Where to go next
• Sessions and devices
  • Starting a session
  • Sample rate
  • Offline sessions
  • Choosing an audio device
  • Is audio flowing?
  • MIDI devices
  • Where to go next
• Install
  • Linux (Debian / Ubuntu)
  • Linux (Fedora / RHEL)
  • Windows (MSYS2 Clang64)
  • Android
  • Adding libYSE to your CMake project
  • Verifying the install
  • Next
• Hello, sound
  • What just happened
  • What’s not here

Tutorials

• Tutorials
  • Phase 1 — Fundamentals
  • Phase 2 — Spatial audio and mixing
  • Phase 3 — Effects and streaming
  • Phase 4 — Advanced DSP and integration
  • Phase 5 — Synthesis and control
  • Phase 6 — Synths, instruments, and effects
  • Phase 7 — Musical time
  • How to follow along

Patcher

• Patcher
  • Signal objects and control objects
  • Hosting a patcher
  • Where to go next

Live coding

• Live coding
  • Running a script
  • The primitives
  • Hot-reload pattern
  • Addressing
  • A worked example
  • Threading in one sentence

API reference

• API Reference
  • Core
  • Channels
  • Sounds
  • Audio devices
  • MIDI
  • Music
  • Player
  • Clocks and clips
  • Synthesis
  • DSP
  • DSP modules
  • Mixing effects
  • Types, enums and constants
  • Utilities
  • C ABI (language bindings)

Releases

• Upgrading from 2.4 to 3.0