A powerful terminal-based audio visualizer with a plugin system that renders beautiful, responsive visualizations in your terminal. CLI-Viz processes audio from your microphone in real-time and transforms it into captivating visual displays.
- Spectrum Bars: Classic frequency spectrum analyzer with colorful bars
- Controls: b/B - Increase/decrease bass boost
- Wave: Audio-reactive sine wave that changes with different frequencies
- Circle: Circular spectrum visualization with pulsating rings
- Particles: Particle system that responds to beats and energy in the music
- Controls: p/P - Increase/decrease maximum number of particles
- Flame: A realistic flame that dances to your music
- Controls: w/W - Increase/decrease flame width
- Controls: h/H - Increase/decrease flame height
- Fractal Universe: Hypnotic fractal patterns that evolve and respond to audio frequencies
- Matrix Rain: Digital rain effect inspired by The Matrix, with characters that flow and respond to the music
- Neural Dreamscape: Abstract visualization resembling neural networks that pulse and evolve with audio input
- Neural Dreamscape Lite: Optimized version of Neural Dreamscape designed specifically for low-end devices like Raspberry Pi Zero W'
... and more!
- Modular plugin system for visualizers
- Multiple audio-reactive visualizations included
- Real-time audio processing
- Customizable with keyboard controls
- Low resource usage
- Q: Quit the program
- M: Switch to the next visualization
- Space: Pause/resume visualizations
- +/-: Increase/decrease audio sensitivity
- Python 3.6+
- numpy
- pyaudio
- curses (included in the standard library)
# Clone the repository
git clone https://github.com/sam1am/cli-viz.git
cd cli-viz
# Create venv (optional)
python -m venv venv
source ./venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Run the visualizer
python main.pyIf you encounter issues installing PyAudio:
# Install portaudio development package
sudo apt-get install portaudio19-dev python-pyaudio
# Then install PyAudio
pip install pyaudio# Using Homebrew
brew install portaudio
pip install pyaudioYou may need to install PyAudio from a pre-built wheel:
pip install pipwin
pipwin install pyaudioCLI-Viz has a plugin system that makes it easy to create your own visualizations. See the visualizer documentation for details on creating custom visualizers.
Contributions are welcome! Feel free to submit a pull request or open an issue on GitHub.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-visualization) - Commit your changes (
git commit -am 54C9 'Add amazing visualization') - Push to the branch (
git push origin feature/amazing-visualization) - Create a new Pull Request