Native

The web version is fun but this thing really takes life when you use it through the native version. You will need to compile it yourself, read the instructions attached to the repo in order to do so.


Binaries

  • doux runs as an OSC server, listening on a configurable port (default 57120). Use it with TidalCycles, Strudel, or any live doux-repl is an interactive coding compatible tool.

  • REPL with readline support and command history saved to ~/.doux_history. Built-in commands: .quit, .reset, .hush, .panic, .voices, .time.

Flags

FlagShortDescription
--samples-sDirectory containing audio samples
--list-devicesList audio devices and exit
--input-iInput device (name or index)
--output-oOutput device (name or index)
--channelsNumber of output channels (default: 2)
--port-pOSC port, doux only (default: 57120)

Multichannel

The --channels flag enables multichannel output beyond stereo. The number of channels is clamped to your device's maximum supported count.

The orbit parameter controls output routing. With N output channels, there are N/2 stereo pairs. Voices on orbit 0 output to channels 0–1, orbit 1 to channels 2–3, and so on. When the orbit exceeds the number of pairs, it wraps around via modulo.

Effects (delay, reverb) follow the same routing: each orbit's effect bus outputs to its corresponding stereo pair.

Sample loading

The --samples flag allows you to (lazy-)load audio samples to play with. The engine expects a folder containing folders of audio samples. Samples will be available using the folder name. You can index into a folder by using the /n/ command. Check the reference to learn more about this.