leriart

leriart / cava-bg

Public

A high-performance audio visualizer for Wayland compositors

cava hyprland rust wallpaper wayland
10
0
100% credibility
Found Apr 14, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

cava-bg is a native audio visualizer for Wayland desktops that renders real-time CAVA audio bars as a transparent overlay matching the current wallpaper's colors.

How It Works

1
🔍 Discover cava-bg

You hear about cava-bg, a fun tool that makes colorful music bars dance across your desktop background to match your tunes.

2
📥 Get it on your computer

You easily download and set it up following simple steps, like adding it from your software list or building it quickly.

3
⚙️ Tweak your style

You adjust how many bars, their spacing, smoothness, and whether to pull colors from your wallpaper or pick your own.

4
▶️ Launch the visualizer

With one command, it springs to life, overlaying transparent bars that sway perfectly to your music over your wallpaper.

5
🖼️ Change your wallpaper

When you switch backgrounds, the bars automatically shift to beautiful new colors pulled right from the image.

6
🎵 Enjoy the show

Play your favorite songs and watch the bars pulse, glow, and groove in real-time, making your desktop feel alive.

✅ Perfect music vibe

Your screen now has a stunning, responsive visual companion to every beat, easy to start or stop anytime.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is cava-bg?

cava-bg is a Rust-built audio visualizer that overlays real-time CAVA bars as a transparent layer on your Wayland desktop wallpaper, perfect for Hyprland, Sway, or River users wanting high-performance audio visuals without window clutter. It auto-extracts gradient colors from your current wallpaper and updates them dynamically when you switch backgrounds via tools like hyprpaper, swww, or waypaper. Run it with a simple `cava-bg` command, tweak via TOML config for bar count, framerate, and smoothing, and kill with `cava-bg kill`.

Why is it gaining traction?

Unlike terminal-based visualizers or heavy Electron apps, cava-bg delivers GPU-accelerated rendering via wgpu for silky 60fps performance on native Wayland layer shells, staying lightweight by spawning just one CAVA process. The killer hook is seamless wallpaper integration—colors adapt automatically every few seconds, with fallbacks to static palettes, making high-performance audio overlays feel native to your setup. Multi-monitor support and low-latency audio keep it snappy even on dynamic desktops.

Who should use this?

Wayland tinkerers on Arch (AUR-ready) who run Hyprland or Sway and crave ambient music visuals that blend into their workflow, like developers jamming to tunes while coding. It's for users of wallpaper daemons like mpvpaper or ambxst tired of mismatched themes, or anyone seeking a cava bg ky-style background remover vibe but for audio bars.

Verdict

Grab it if you're on Wayland and want polished audio visuals—solid docs and easy install make the 10 stars and 1.0% credibility score forgivable for this early Rust gem. Still maturing with room for broader distro support, but it nails the niche today.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.