Files
beatglow/README.md
T

4.4 KiB

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

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. ↩︎