Doc no. SK-404DatasheetRev 2026.11Sheet 2.20 of 4
Music Visualiser
Terminal ASCII and pixel music visualiser for macOS with FFT bars, synced lyrics and album art, plus ESP32 firmware that shows a spectrum on an OLED.
Active
Source on GitHub
$ cd macos && ./run.sh /path/to/music
Block diagram
Characteristics
| Terminal render | True-colour half-block album art (▀), eighth-block FFT bars (▁▂▃▄▅▆▇█), and a high-res braille oscilloscope |
|---|---|
| Media decoding | Reads audio streams and tags (cover art, title, artist, album, year) across mp3, m4a, flac, wav, aiff, ogg, opus and wma |
| Synced lyrics | Renders timed .lrc karaoke highlighting with stacked original, romanization and translation layers |
| Queue & modes | Interactive album-grouped queue, shuffle/repeat toggles and three switchable views (bars+wave, bars, wave) |
| ESP32 companion | PlatformIO firmware turning an ESP32 + SSD1306 OLED into a Bluetooth A2DP sink with live spectrum and track banner |
Overview & build notes
Two paired visualisers built around the same real-time FFT spectrum concept: a macOS Python terminal player under macos/ and an ESP32 Bluetooth receiver under esp32/.
In the terminal app, embedded album covers render at sub-character vertical resolution via ANSI true-colour half-blocks alongside Unicode eighth-block spectrum analyzers, braille waveforms and CJK-aligned multi-language .lrc lyrics.
On hardware, an ESP32 pairs to your Mac or phone over Bluetooth A2DP audio and drives a monochrome 128×64 SSD1306 OLED with live spectrum bars and scrolling track metadata; GitHub Actions lints and tests both targets on every push.
Files & artifacts
| Kind | File | Details | Size |
|---|---|---|---|
| Python | macos/ | Terminal player, FFT analyzer, half-block cover art and .lrc renderer on GitHub | GitHub |
| Firmware | esp32/ | PlatformIO Bluetooth A2DP sink and SSD1306 OLED spectrum display on GitHub | GitHub |
| Script | shell-integration.zsh | Zsh helper for launching playback cleanly from any folder on GitHub | GitHub |
| Docs | README.md | Keybindings, codec support and ESP32 wiring table on GitHub | GitHub |