Omahub
← All plugins
C

Audio Visualizer

by CyfrowyNomada

A live PipeWire/PulseAudio spectrum visualizer for the Omarchy bar.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
252ec3a
Scanned
1 month 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
252ec3a
Reviewed
1 month ago

The plugin is a benign audio visualizer that runs a user-level Python helper to capture audio via parec and render frequency bars. No malicious code, destructive commands, or persistence mechanisms were found. The deterministic scan found no issues, and the review confirms the plugin is safe to install.

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/w84death/tiny-audio-visualizer --enable
Widgets #media

Omarchy Audio Visualizer

Audio Visualizer preview

A live, Winamp-style spectrum visualizer for the Omarchy bar.

It captures the current PipeWire/PulseAudio default monitor and renders frequency bands directly with a QML Canvas. Right-click the widget to open an Omarchy-style settings popup.

Features

  • Frequency spectrum analyzer, low → high from left to right
  • Bar, filled-wave, and dot render styles
  • B/W, gray-gradient, and rainbow color modes
  • Runtime controls for pause/start, width, refresh rate, style, and colors
  • Configurable FPS, gain, source, width, and band count

Requirements

  • Omarchy Quattro shell

No manual setup or root privileges are required. The plugin uses the python3, parec, and PipeWire/PulseAudio components already included with Omarchy. It runs inside the normal long-running Omarchy shell process and starts one user-owned parec capture process plus the local audio-visualizer Python helper.

Install

After this repository is public, install with:

omarchy plugin add https://git.cyfrowynomada.com/CyfrowyNomada/audio-visualizer.git --enable

Then place it on the bar if needed:

omarchy bar move com.cyfrowynomada.audio-visualizer --section center

Usage

  • Left click: open audio controls (pavucontrol if available, otherwise wpctl status)
  • Right click: open visualizer options

The right-click popup lets you change:

  • Start/pause
  • Width: 64px–256px in 8px steps
  • Refresh rate: 15/30/45/60 FPS
  • Shape: spectrum bars, filled spectrum wave, spectrum dots
  • Colors: B/W theme, gray gradient, rainbow

Configuration

You can also configure it inline in ~/.config/omarchy/shell.json:

{
  "id": "com.cyfrowynomada.audio-visualizer",
  "width": 152,
  "samples": 48,
  "fps": 30,
  "drawMode": "bars",
  "colorStyle": "bw",
  "gain": 12.0,
  "source": "@DEFAULT_MONITOR@",
  "showWhenSilent": true
}

Settings:

Setting Default Description
width 152 Widget width in pixels, clamped to 64–256
samples 72 Number of frequency bands/lanes
fps 45 Analyzer refresh rate; menu offers 15/30/45/60
drawMode bars bars, wave, or dots
colorStyle bw bw, gray, or rainbow
gain 12.0 Spectrum sensitivity
source @DEFAULT_MONITOR@ Pulse/PipeWire recording source
showWhenSilent true Keep the widget visible during silence

Remove

omarchy plugin remove com.cyfrowynomada.audio-visualizer

If you manually added a layout entry, remove it from ~/.config/omarchy/shell.json or move another widget into its place.

Development

Validate the manifest and QML from the repository root:

omarchy plugin validate .
qmllint -I "$OMARCHY_PATH/shell" BarWidget.qml

For local testing without publishing:

mkdir -p ~/.config/omarchy/plugins/com.cyfrowynomada.audio-visualizer
cp -a manifest.json BarWidget.qml audio-visualizer README.md LICENSE ~/.config/omarchy/plugins/com.cyfrowynomada.audio-visualizer/
chmod +x ~/.config/omarchy/plugins/com.cyfrowynomada.audio-visualizer/audio-visualizer
omarchy-shell shell rescanPlugins

License

MIT — see LICENSE.