# 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](asset/image/beatglow-playing.gif) Stereo spectrum waterfall display (also supports mono): ![BeatGlow main display with waterfall](asset/image/beatglow-playing-waterfall.gif) ### Settings Live adjust settings from the rotary dail. ![BeatGlow settings display](asset/image/beatglow-settings.gif) ### Spectrum analyzer ![BeatGlow spectrum analyzer](asset/image/beatglow-spectrum-analyzer.gif) ![BeatGlow spectrum waterfall](asset/image/beatglow-spectrum-waterfall.gif) ### Shader ![BeatGlow shader audio intensity bars](asset/image/beatglow-shader-audio-intensity-bars.gif) ![BeatGlow shader etc.](asset/image/beatglow-shader-etc.gif) ## 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: - Raspberry Pi 3B+/4B+ - SSD1322 OLED Display 3.12" 256x64 - Display purchase options: - [AliExpress](https://s.click.aliexpress.com/e/_onJsYxJ) [^1] - [AudioPhonics.fr](https://www.audiophonics.fr/en/screens-vu-meters/white-spi-iic-256x64-oled-312-screen-p-14604.html) #### 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](asset/image/setup-ssd1322.png) | Wire | Function | Raspberry Pi | Display | | -------------------------------- | --------- | --------------- | ------- | | ![](asset/image/wire-black.png) | Ground | Pin 20 (GND) | Pin 1 | | ![](asset/image/wire-yellow.png) | 3.3V | Pin 17 (3.3V) | Pin 2 | | ![](asset/image/wire-orange.png) | SPI Clock | Pin 23 (GPIO11) | Pin 4 | | ![](asset/image/wire-blue.png) | SPI Data | Pin 19 (GPIO10) | Pin 5 | | ![](asset/image/wire-white.png) | SPI D/C | Pin 18 (GPIO24) | Pin 14 | | ![](asset/image/wire-brown.png) | SPI Reset | Pin 22 (GPIO25) | Pin 15 | | ![](asset/image/wire-red.png) | SPI C/E | Pin 24 (GPIO8) | Pin 16 | #### Configuration The display configuration in `beatglow.conf` is as follows: ```ini # 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: - Raspberry Pi 3B+/4B+ - ST7735/ST8889 IPS display - Display purchase options: - [AliExpress](https://s.click.aliexpress.com/e/_onuTZPb) [^1] - [Waveshare](https://www.waveshare.com/1.9inch-lcd-module.htm) #### Configuration The display configuration in `beatglow.conf` is as follows: ```ini 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.