visyx

A high-performance, terminal-based audio spectrum visualizer written in Rust that transforms your audio into mesmerizing real-time visual patterns.

What It Does

visyx captures your system audio, breaks it into frequency bands with a mel-scale FFT, and renders it as smooth, physics-driven bars in the terminal. Adaptive gain and noise gating keep the visuals clean, while zero-copy rendering ensures 60+ FPS with minimal latency. Multiple layouts are supported, and it runs cross-platform on Linux, macOS, and Windows, given you have Rust installed.

Installation

cargo install visyx

Basic Usage

Simply run the visualizer with default settings:

visyx

Controls:

• q - Quit the application

Configuration

You can fine-tune the visualization for your specific audio setup and preferences using these environment variables.

Settings

Performance & Display

Audio Processing

Animation Physics

Example Configurations

High-Resolution Mode (more frequency detail):

VISYX_FFT_SIZE=4096 VISYX_FMIN=20 VISYX_FMAX=20000 visyx

Performance Mode (smooth on lower-end systems):

VISYX_TARGET_FPS_MS=33 VISYX_FFT_SIZE=1024 visyx

Bass-Heavy Music:

VISYX_FMIN=20 VISYX_FMAX=8000 VISYX_TILT_ALPHA=0.1 visyx

Classical Music:

VISYX_FMIN=40 VISYX_FMAX=12000 VISYX_TAU_SPEC=0.12 visyx

How It Works

visyx runs a fast, low-latency audio pipeline built to turn raw sound into smooth, responsive visuals. It starts by hooking directly into your system audio, through a loopback device, so what you see is exactly what you hear, no setup friction, no manual wiring.

The signal is then windowed with Hann smoothing to avoid leakage and pushed through an FFT to break the stream into frequency components. Those raw bins are remapped onto a mel-scale filterbank so the output reflects how we actually perceive sound rather than just a grid of math.

To keep the display clean and balanced, it constantly adjusts its dynamic range. It tracks energy percentiles to scale loudness in real time, cuts off background hiss with noise gating, and applies frequency tilt so no single band overwhelms the others. The result is a visual field that feels natural and reacts instantly to changes in the mix.

On top of that sits a lightweight physics model. Instead of raw bar jumps, visyx runs each band through a spring-damper system so motion carries weight and flow. Energy diffuses between neighbors, giving the spectrum a fluid, wave-like feel. Every calculation is written to avoid allocations on the hot path, which means it runs smooth even at high refresh.

Finally, the renderer pushes everything to the terminal with dense Unicode block characters, letting gradients show up clean without burning cycles. FFT calls are SIMD-accelerated where hardware allows, memory access is cache-friendly, and processing adapts automatically to the system it runs on.

On modern machines, this translates to a consistent 60+ frames per second with sub-5ms audio latency—snappy enough that the visuals feel like part of the sound itself.

License

MIT