Skip to content

README.md

Latest commit

 

History

History
57 lines (38 loc) · 1.44 KB

README.md

File metadata and controls

57 lines (38 loc) · 1.44 KB
Raw

Overview

An audio visualizer for Raspberry Pi using WS28xx RGB LED matrices.

Features audio input from an I2S MEMS microphone via a custom ALSA configuration. See matrix wiring information for setup details. Uses the great Cava software for audio visualization.

Built during coursework at NCU Toruń.

Installation

Requires cava to be installed on the system.

Option 1: Direct installation on Pi

git clone https://github.com/sazonek/spectro-rust.git
cd spectro-rust
cargo install spectro-rust --path .

Option 2: Cross-compilation (Recommended)

Compile using cross with the supplied Docker image:

cross build --target aarch64-unknown-linux-gnu --release

Then copy the binary to your Pi:

scp target/aarch64-unknown-linux-gnu/release/spectro-rust pi@raspberrypi.local:/home/pi/

Usage

After installation, run the visualizer:

./spectro-rust

Config file should be placed in the same directory as the binary.

Uninstallation

If installed via cargo:

cargo uninstall spectro-rust

Credits