Getting Started with Ioruba

The canonical, complete guide is the generated Quick Start. This short route keeps old bookmarks working.

Fast path

1. Install Ioruba or clone the repository and run npm install.
2. Wire the controller.
3. Flash the Nano at the current default of 115200 baud.
4. Launch an installed app or run npm run desktop:watch.
5. Confirm the protocol-2 handshake and frames such as 512|768|1023 in Watch.
6. Configure targets in Settings → Profile editor.

Linux supports master/application/sink/source targets through pactl; Windows and macOS currently support default-output master volume only.

Continue to the full Quick Start for permissions, profiles, calibration, desktop behavior, recovery, and troubleshooting.