Omahub
← All plugins
G

QuattroWave

by Grok (xAI)

Cava audio visualizer for the Omarchy bar. One process, every monitor, live theme colors.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
50f9e89
Scanned
3 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
50f9e89
Reviewed
3 weeks ago

The plugin is a QML bar widget and service that launches cava through a small, readable bash helper. No obfuscation, credential access, persistence, or destructive behavior was found; the helper validates its numeric arguments and only writes a config/lock file under the user's runtime directory. The deterministic scan found no issues and the manual review agrees.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/ltehacker/omarchy-quattro-wave --enable
Appearance #bar #quickshell #media

QuattroWave

Bounce

Built with Grok · Cava visualizer integration for Omarchy Quattro quickshell

Bounce

One cava process feeds every monitor. Bars are real rectangles, not Unicode blocks. Theme swaps recolor them live from Omarchy's Color singleton (accent, muted, bar foreground).

Requirements

  • Omarchy / omarchy-shell
  • cava — omarchy pkg add cava
  • Pipewire

Install

omarchy plugin add https://github.com/ltehacker/omarchy-quattro-wave --enable

Then place it, if it did not land where you want:

omarchy bar move itdir.cava --section left --after omarchy.menu

Validate a local checkout:

omarchy plugin validate ~/.config/omarchy/plugins/itdir.cava

Remove

omarchy plugin disable itdir.cava
omarchy plugin remove itdir.cava --yes

disable takes it off the bar. remove deletes the checkout. cava itself is left installed.

Settings

Inline on the bar entry in ~/.config/omarchy/shell.json, or:

omarchy bar set itdir.cava color gradient
omarchy bar set itdir.cava bars 24
Key Default What it does
bars 16 Number of spectrum bars (4–64)
color accent accent, foreground, or gradient
framerate 30 cava frames per second (10–60)
hideWhenSilent false Hide the widget when the spectrum is quiet
  • accent — Color.accent from the active theme
  • foreground — the bar's current text color (tracks transparent-bar contrast)
  • gradient — each bar mixes Color.muted → Color.accent by amplitude

Right-click the widget to restart cava. Changing bars or framerate restarts cava once.

Works on top/bottom bars and on left/right bars (bars grow toward the desktop).

License

MIT. See LICENSE.