Oscilloscope Video Generator

A high-performance Rust tool for generating oscilloscope-style visualizations from audio files. Uses parallel rendering for fast processing.

Features

• Multiple visualization modes: combined, separate, all (L/R + XY)
• Parallel rendering: Uses all CPU cores for fast frame generation
• High quality output: Supports up to 4K resolution at 60fps
• Original audio: Copies audio stream without re-encoding (perfect sync)
• Customizable: Colors, resolution, FPS, line thickness

Installation

From Source

cd oscilloscope-video-gen
cargo install --path .

Build Only

cargo build --release

The binary will be at target/release/oscilloscope-video-gen.

Usage

Basic

oscilloscope-video-gen -i audio.wav -o video.mp4

Full Options

oscilloscope-video-gen \
  -i audio.wav \
  -o video.mp4 \
  --width 1920 \
  --height 1080 \
  --fps 30 \
  --mode all \
  --quality high \
  --left-color "#00ff00" \
  --right-color "#00ccff" \
  --xy-color "#ff8800" \
  --background "#0a0f0a" \
  --line-thickness 2 \
  --threads 8 \
  --overwrite \
  --verbose

Options

Option	Default	Description
-i, --input	Required	Input WAV file
-o, --output	Auto-generated	Output MP4 file
--width	1920	Video width in pixels
--height	1080	Video height in pixels
--fps	30	Frames per second
--mode	all	Visualization mode
--quality	high	Video quality
--left-color	#00ff00	Left channel color (hex)
--right-color	#00ccff	Right channel color (hex)
--xy-color	#ff8800	XY mode color (hex)
--background	#0a0f0a	Background color (hex)
--show-grid	true	Show grid lines
--line-thickness	2	Line thickness in pixels
--threads	All cores	Number of rendering threads
--overwrite	false	Overwrite output file
--verbose	false	Enable verbose output

Modes

• combined: Both channels merged into single waveform
• separate: Left on top, Right on bottom
• all: Left and Right on top row, XY pattern on bottom

Quality Presets

Preset	Video Bitrate
low	2 Mbps
medium	5 Mbps
high	10 Mbps

Requirements

• Rust 1.70+
• ffmpeg (for video encoding)

Building

# Debug build
cargo build

# Release build (optimized)
cargo build --release

# Build with specific number of threads
cargo build --release --jobs 8

Troubleshooting

ffmpeg not found

Make sure ffmpeg is installed and in your PATH:

# Ubuntu/Debian
sudo apt install ffmpeg

# macOS
brew install ffmpeg

# Windows
winget install FFmpeg

Out of memory

For very long audio files, try:

• Lower resolution (--width 1280 --height 720)
• Lower FPS (--fps 24)
• Fewer threads (--threads 4)

License

MIT