scope-tui/README.md

scope-tui

A simple oscilloscope/vectorscope in your terminal

Currently only for Linux (with Pulseaudio)

Why

I really love cava. It provides a crude but pleasant frequency plot for your music: just the bare minimum to see leads solos and basslines. I wanted to also be able to see waveforms, but to my knowledge nothing is available. There is some soundcard oscilloscope software available, but the graphical GUI is usually dated and breaks the magic. I thus decided to solve this very critical issue with my own hands! And over a night of tinkering with pulseaudio (via libpulse-simple-binding) and some TUI graphics (via tui-rs), the first version of scope-tui was developed, with very minimal settings given from command line, but a bonus vectorscope mode baked in.

Usage

$ scope-tui [OPTIONS] <WIDTH>

Arguments:
  <WIDTH>  Size of audio buffer, and width of scope

Options:
  -d, --device <DEVICE>  Audio device to attach to
  -s, --scale <SCALE>    Max value on Amplitude scale [default: 20000]
      --no-reference     Don't draw reference line
      --no-braille       Don't use braille dots for drawing lines
      --scatter          Use vintage looking scatter mode
      --vectorscope      Combine left and right channels into vectorscope view
  -h, --help             Print help information
  -V, --version          Print version information

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 8192

Controls

• Use q or CTRL+C to exit. Not all keypresses are caught, so keep trying... (wip!)
• Use <SPACE> to pause and resume display
• Decrease/increase terminal font size to increase/decrease scope resolution.