Matrix Music Viz

Music spectrum visualizer for the Adafruit Matrix Portal M4 driving a 64x32 RGB matrix panel. The firmware samples audio, runs an FFT, and renders 32 bars with optional visual styles and palettes.

Hardware

• Adafruit Matrix Portal M4
• 64x32 HUB75 RGB matrix panel
• Line-level audio input circuit (AC-coupled with bias to 3.3 V)

Build and Upload (PlatformIO)

1. Install PlatformIO.
2. Open this project folder in your editor.
3. Build and upload:

pio run -t upload

Monitor serial output:

pio device monitor -b 115200

Configuration

Tuning and display configuration live in src/main.cpp, including sample rate, frequency range, bar smoothing, and palette selection.

Notes

• Display orientation: if the panel is mirrored, set FLIP_X = true. If the panel is rotated 180 degrees, draw overlay text with setRotation(2).
• FFT setup: 256 samples at 12 kHz (Nyquist 6 kHz) with a 40-6000 Hz display range and hybrid low-band mapping.
• Noise handling: dynamic noise floors and high-band gating are enabled.

License

MIT. See LICENSE.