NOTE: The Proteus Audio Project is still in early development. The apps likely contain issues and may not always work as expected. If you encounter problems, please report them on one of the project’s GitHub repositories. If you are a developer and want to help, feel free to open a PR or reach out to [email protected].
Proteus Audio wave icon

Proteus Audio

Proteus

Playback

Run prot with a file or directory path to start interactive playback.

prot song.prot
prot song.mka
prot take.wav
prot ./song-project

Supported standalone audio extensions include wav, wave, flac, aif, aiff, mp3, m4a, aac, ogg, and opus.

Playback Options

Set initial playback gain as a percentage:

prot song.prot --gain 80

Seek before playback starts:

prot song.prot --seek 45

Load an effects chain from JSON:

prot song.prot --effects-json effects_chain.json

Run without the terminal UI:

prot song.prot --quiet

Interactive Controls

While playback is running:

  • space toggles play and pause.
  • s shuffles the current Proteus selection.
  • left arrow seeks backward five seconds.
  • right arrow seeks forward five seconds.
  • r toggles reverb.
  • - lowers the reverb mix.
  • = or + raises the reverb mix.
  • q exits.
  • ctrl-c exits.

Buffering Options

These options tune playback startup and buffering behavior:

prot song.prot --start-buffer-ms 20
prot song.prot --start-sink-chunks 3
prot song.prot --max-sink-chunks 40
prot song.prot --startup-silence-ms 0
prot song.prot --startup-fade-ms 150

--append-jitter-log-ms logs sink append jitter events above a threshold. --effect-boundary-log logs per-effect discontinuities in the DSP chain.

Duration Inspection

Print duration metadata and exit:

prot song.prot --read-durations

Scan packets to compute per-track durations and exit:

prot song.prot --scan-durations

© 2026 - Proteus Audio Project