2026-10-29 17:29:41 +01:00
2026-10-29 17:29:41 +01:00
2026-10-29 17:29:54 +01:00
2026-10-29 17:29:41 +01:00
2026-10-29 17:26:07 +01:00
2026-10-29 17:29:54 +01:00
2026-10-29 17:29:41 +01:00

BeatGlow

Visualizer for audiophile streamers (or enthousiasts alike).

State of the project

Work in progress!

Features

Main display

Showing what track is currently playing.

Features:

  • Audio format, bitrate and output sample rate display
  • Track elapsed and duration
  • Track album art
  • Spectrum analyzer / Waterfall display of the track playing

Mono spectrum analyzer (also supports stereo):

BeatGlow main display

Stereo spectrum waterfall display (also supports mono):

BeatGlow main display with waterfall

Settings

Live adjust settings from the rotary dail.

BeatGlow settings display

Spectrum analyzer

BeatGlow spectrum analyzer

BeatGlow spectrum waterfall

Shader

BeatGlow shader audio intensity bars

BeatGlow shader etc.

Performance

Tests have been performed on a Raspberry Pi 4B+ with 4GB RAM, with a 256x64x4 pixel display running at 25 frames per second. Lowering the frame rate also lowers resource utilisation at the expensive of less fluid animations.

CPU usage

During the main display with stereo spectrum analyzer, running 44.1kHz stereo audio: 9% CPU, 20MB RAM.

During the full screen stereo spectrum analyzer, running 44.1kHz stereo audio: 10% CPU, 20MB RAM.

During the shader, running various shader effects, running 44.1kHz stereo audio: 40-50% CPU, 21MB RAM.

Setup

When the audio source uses type = "fifo", MPD-based players check the output status after connecting and every 15 seconds. BeatGlow logs a warning if the matching output is disabled or missing, and reports when it becomes enabled. It does not enable outputs automatically. A single FIFO output is selected automatically. If MPD has multiple FIFO outputs, set output = "BeatGlow" in the audio block, using the name of the MPD output that writes to your FIFO. Older MPD versions that omit the output plugin also require this name. MPD does not expose FIFO paths through its output status, so the configured output must write to the same path as the audio source.

Minimal requirements:

  • Linux Computer (Raspberry Pi 3B+)
  • Supported display

Setup Raspberry Pi & SSD1322 256x64 OLED display

Requirements:

Wiring

Wiring the display is as follows, looking at the OLED display connector from the back (pin 1 on the top left, pin 16 on the bottom right):

SSD1322 setup

Wire Function Raspberry Pi Display
Ground Pin 20 (GND) Pin 1
3.3V Pin 17 (3.3V) Pin 2
SPI Clock Pin 23 (GPIO11) Pin 4
SPI Data Pin 19 (GPIO10) Pin 5
SPI D/C Pin 18 (GPIO24) Pin 14
SPI Reset Pin 22 (GPIO25) Pin 15
SPI C/E Pin 24 (GPIO8) Pin 16

Configuration

The display configuration in beatglow.conf is as follows:

# Display hardware configuration.
display {
    # Target frame rate, actual frame rate depends on hardware options.
    fps = 25

    # Main display is where all the magic happens.
    main {
        # Type of display
        type  = "ssd1322"
        size  = "256x64"

        # Mode (spi or i2c)
        mode  = "spi"

        # SPI settings
        port  = "spi0.0"
        reset = "GPIO25"
        dc    = "GPIO24"
        bl    = "GPIO23"
    }
}

Setup Raspberry Pi & ST7789 170x320 IPS display

Requirements:

Configuration

The display configuration in beatglow.conf is as follows:


display {
    # Target frame rate, actual frame rate depends on hardware options.
    fps = 25

    # Main display is where all the magic happens.
    main {
        # Type of display
        type   = "st7789"  # or st7735
        size   = "320x130"
        rotate = "left"

        # Mode (spi or i2c)
        mode  = "spi"

        # SPI settings
        port  = "spi0.0"
        reset = "GPIO25"
        dc    = "GPIO24"
        bl    = "GPIO23"
    }
}

  1. Affiliate links, by clicking them and making an order there is a small kick back for me, which allows me to order parts for testing. There is usually no additional costs for the purchaser. ↩︎

S
Description
BeatGlow is a music visualiser for embedded audio players
Readme MIT
125 MiB
0 Stars 1 Watchers 0 Forks
Languages
Go 100%