proteus-cli 0.6.1

A command line utility for playing .prot audio files.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# Proteus CLI

Command-line player for `.prot` and `.mka` containers powered by `proteus-lib`.

**Usage**
- `cargo run -p proteus-cli -- /path/to/file.prot`
- `cargo run -p proteus-cli -- /path/to/file.mka`

**Controls**
- `space` play/pause
- `s` shuffle
- `←/→` seek 5s
- `r` toggle reverb
- `-` / `=` adjust reverb mix
- `q` quit

**Debug**
- `cargo run -p proteus-cli --features debug -- /path/to/file.prot`
- `RUST_LOG=debug` enables debug logging

**CLI Options**
```text
Usage: proteus-cli [OPTIONS] [INPUT]

Arguments:
  [INPUT]  The input file path, or - to use standard input

Options:
  -s, --seek <TIME>                    Seek to the given time in seconds
  -g, --gain <GAIN>                    The playback gain [default: 70]
      --bench-dsp                      Run a synthetic DSP benchmark and exit
      --bench-sweep                    Run a sweep over multiple FFT sizes and exit
      --bench-fft-size <SIZE>          FFT size for DSP benchmark [default: 24576]
      --bench-input-seconds <SECONDS>  Input length in seconds for DSP benchmark [default: 1.0]
      --bench-ir-seconds <SECONDS>     Impulse response length in seconds for DSP benchmark [default: 2.0]
      --bench-iterations <COUNT>       Number of iterations for DSP benchmark [default: 5]
      --start-buffer-ms <MS>           Amount of audio (ms) to buffer before starting playback [default: 20]
      --track-eos-ms <MS>              Heuristic end-of-track threshold in ms for container tracks [default: 1000]
      --read-durations                 Read track durations metadata, then exit
      --scan-durations                 Scan all packets to compute per-track durations, then exit
      --decode-only <decode-only>      Decode, but do not play the audio
      --probe-only <probe-only>        Only probe the input for metadata
      --verify-only <verify-only>      Verify the decoded audio is valid, but do not play the audio
  -v, --verify <verify>                Verify the decoded audio is valid during playback
      --no-progress <no-progress>      Do not display playback progress
      --no-gapless <no-gapless>        Disable gapless decoding and playback
  -q, --quiet                          Suppress all console output
  -d <debug>                           Show debug output
  -h, --help                           Print help
  -V, --version                        Print version
```

**Notes**
- Logs are captured and shown in the TUI while the interface is active.