aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
author alemi <[email protected]>2025-11-07 01:45:52 +0100
committer alemi <[email protected]>2025-11-07 01:45:52 +0100
commit09d7331d0f0abeb646c3c352897b37daf5a89f79 (patch)
treecfc3c759c8e2b538b85434375988db650a9a727c
parentc2f3392805b58fc14fcaebe59ed5ff16249b83b1 (diff)
docs: update usage flags on readmeHEADdev
-rw-r--r--README.md27
1 files changed, 15 insertions, 12 deletions
diff --git a/README.md b/README.md
index 4ef2374..622706f 100644
--- a/README.md
+++ b/README.md
@@ -56,23 +56,26 @@ Enable sources by passing the respective feature flags while compiling: `--featu
Usage: scope-tui [OPTIONS] <COMMAND>
Commands:
+ pulse use PulseAudio Simple api to read data from an audio sink
file use a file from filesystem and read its content
audio use new experimental CPAL backend
- pulse use PulseAudio Simple api to read data from an audio sink
help Print this message or the help of the given subcommand(s)
Options:
- --channels <N> number of channels to open [default: 2]
- -b, --buffer <SIZE> size of audio buffer, and width of scope [default: 2048]
- --sample-rate <HZ> sample rate to use [default: 48000]
- --tune <NOTE> tune buffer size to be in tune with given note (overrides buffer option)
- -s, --scale <x> floating point vertical scale, from 0 to 1 [default: 1]
- --scatter use vintage looking scatter mode instead of line mode
- --no-reference don't draw reference line
- --no-ui hide UI and only draw waveforms
- --no-braille don't use braille dots for drawing lines
- -h, --help Print help
- -V, --version Print version
+ -c, --channels <N> number of channels to open [default: 2]
+ -b, --buffer <SIZE> size of audio buffer, and width of scope [default: 2048]
+ -r, --sample-rate <HZ> sample rate to use [default: 48000]
+ -t, --tune <NOTE> tune buffer size to be in tune with given note (overrides buffer option)
+ -s, --scale <x> floating point vertical scale, from 0 to 1 [default:1]
+ --scatter use vintage looking scatter mode instead of line mode
+ --no-reference don't draw reference line
+ --no-ui hide UI and only draw waveforms
+ --no-braille don't use braille dots for drawing lines
+ --palette-color <color1,color2> palette to use for scope signal lines [default: red,yellow,green,magenta]
+ --labels-color <color> color to use for axis labels [default: Cyan]
+ --axis-color <color> color to use for axis lines [default: DarkGray]
+ -h, --help Print help
+ -V, --version Print version
```
The audio buffer size directly impacts resource usage, latency and refresh rate and its limits are given by the audio refresh rate. Larger buffers are slower but less resource intensive. A good starting value might be `2048` at `48kHz`, which should guarantee at least 20 frames per second. Increasing sample rate and decreasing buffer size will allow scope-tui to refresh the screen faster.