SK-404

Doc no. SK-404DatasheetRev 2026.11Sheet 2.20 of 4

U8

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

01

Block diagram

Audio filemp3 · flac · m4a … Decodetags + artwork FFTspectrum · wave Terminaltruecolour blocks BluetoothA2DP audio ESP32A2DP sink FFTlive spectrum SSD1306 OLEDspectrum + title
Fig. 1: Two visualisers, one signal path
02

Characteristics

Terminal renderTrue-colour half-block album art (▀), eighth-block FFT bars (▁▂▃▄▅▆▇█), and a high-res braille oscilloscope
Media decodingReads audio streams and tags (cover art, title, artist, album, year) across mp3, m4a, flac, wav, aiff, ogg, opus and wma
Synced lyricsRenders timed .lrc karaoke highlighting with stacked original, romanization and translation layers
Queue & modesInteractive album-grouped queue, shuffle/repeat toggles and three switchable views (bars+wave, bars, wave)
ESP32 companionPlatformIO firmware turning an ESP32 + SSD1306 OLED into a Bluetooth A2DP sink with live spectrum and track banner
  • ASCII art
  • ESP32
  • SSD1306
03

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.

04

Files & artifacts

KindFileDetailsSize
Pythonmacos/Terminal player, FFT analyzer, half-block cover art and .lrc renderer on GitHubGitHub
Firmwareesp32/PlatformIO Bluetooth A2DP sink and SSD1306 OLED spectrum display on GitHubGitHub
Scriptshell-integration.zshZsh helper for launching playback cleanly from any folder on GitHubGitHub
DocsREADME.mdKeybindings, codec support and ESP32 wiring table on GitHubGitHub

U2music-tools