WaveTerm is a modern terminal-based music visualizer inspired by web audio visualizers. Perfect for headless servers, development environments, and live performances with 15+ stunning visualizations across Basic, Advanced, and Extreme modes.
✨ Features
- 15+ Stunning Visualizations: Frequency bars, matrix rain, particle fields, starfield warp, ASCII flames, 4D hypercubes, fractal trees, dimensional portals, and more
- Headless Server Ready: Audio simulation with 8 realistic patterns (electronic, rock, ambient, jazz, dubstep, classical, techno, chill)
- Multiple Input Sources: Microphone, audio files, or simulated audio patterns
- Modern CLI Interface: Rich formatting with Click commands and interactive controls
- Plugin Architecture: Extensible system for custom visualizations
- Cross-Platform: Linux, macOS, Windows support
🚀 Quick Install
# Add repository
sudo dnf config-manager --add-repo https://repos.musicsian.com/musicsian.repo
# Install package
sudo dnf install waveterm
# Try the demo with simulated audio
waveterm-demo
# Run with specific visualization mode
waveterm --mode starfield
# Run with audio simulation pattern
waveterm --simulation electronic
Available Visualization Modes
# Basic Visualizations
bars - Classic frequency spectrum bars
wave - Oscilloscope-style waveform display
matrix - Matrix-style falling character rain
particles - ASCII particle field that reacts to audio
circle - Circular frequency display radiating from center
# Advanced Visualizations
starfield - Stars flying toward screen, faster with audio
fire - ASCII fire effect that reacts to audio
ocean - Wave interference patterns
dna - Rotating DNA double helix
neural - Neural network with pulsing connections
# Extreme Visualizations
glitch - Digital glitch effects with corruption
void - Lovecraftian tentacles from the void
hypercube - 4D tesseract projection
fractal - Recursive fractal tree generation
portal - Swirling interdimensional portal
CLI Usage Examples
# Start with default visualization
waveterm
# Use specific mode and audio pattern
waveterm --mode glitch --simulation dubstep
# List all available modes
waveterm --list-modes
# Show help and options
waveterm --help
# Demo mode with cycling visualizations
waveterm-demo --duration 30