Omahub
← All plugins
E

Lofi Radio

by espi

Play a configurable audio-only focus stream from the Omarchy bar.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

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

The plugin is a straightforward media player that launches a headless Chromium instance to play YouTube audio streams. The control script includes careful process identity verification to avoid killing unrelated processes, and all runtime files are stored in private per-user directories. No malicious, obfuscated, or destructive behavior was found.

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/JovannyEspinal/omarchy-lofi-radio --enable
Widgets #bar #media

Lofi Radio for Omarchy

Continuous Lofi Hip Hop and Synthwave radio in the Omarchy Quattro bar, with headless playback and a live, theme-aware equalizer.

Lofi Radio playback, station switching, and live equalizer demo

Ready Playing in the bar
Lofi Radio idle hover controls Lofi Radio inline bar equalizer

This project is unofficial and is not affiliated with Omarchy, YouTube, or Lofi Girl. Stream availability and rights remain with their respective owners.

Features

  • Audio-only playback with no video window
  • Clear playing, paused, idle, and error states in the bar
  • Inline and hover equalizers driven by the actual PipeWire output
  • Configurable 15–120 FPS visualizer (60 FPS by default)
  • Play/pause, station switching, and stop controls
  • Single-player locking and private per-user runtime files
  • Continuous playback through YouTube's official player in headless Chromium
  • YouTube Premium support through a dedicated, persistent Chromium profile
  • Desktop notifications for invalid settings and missing dependencies
  • Runtime diagnostics in $XDG_RUNTIME_DIR/espi-lofi-radio-$UID/chromium.log

Requirements

  • Omarchy Quattro
  • chromium
  • cava
  • flock and install from standard Arch packages (util-linux, coreutils)

The plugin never requests elevated privileges or installs packages itself.

Install the required packages if they are not already present:

omarchy pkg add chromium cava

YouTube Premium

Sign in once using the plugin's isolated Chromium profile:

~/.config/omarchy/plugins/espi.lofi-radio/control.sh login

Complete the YouTube sign-in in the window that opens, then close that window. Future headless playback uses the same profile, so your Premium membership is recognized without sharing your normal browser profile with the plugin.

Install

omarchy plugin add https://github.com/JovannyEspinal/omarchy-lofi-radio.git --enable

Controls

  • Left click: start or play/pause
  • Middle click: switch between Lofi Hip Hop and Synthwave
  • Right click: stop playback

Playback uses YouTube's official Chromium player with the dedicated profile.

Optional keybindings

The plugin does not install or overwrite keybindings. If these shortcuts are free on your system, add them to ~/.config/hypr/bindings.lua:

local lofi_control =
  os.getenv("HOME") .. "/.config/omarchy/plugins/espi.lofi-radio/control.sh"

o.bind("SUPER + ALT + M", "Lofi Radio: Play/pause", lofi_control .. " toggle")
o.bind("SUPER + ALT + N", "Lofi Radio: Next station", lofi_control .. " switch")
o.bind("SUPER + ALT + X", "Lofi Radio: Stop", lofi_control .. " stop")

Check for conflicts before adding them:

omarchy menu keybindings --print

Hyprland normally reloads the file automatically. Run hyprctl reload if the new shortcuts do not appear immediately. Any other unbound key combinations can be used instead.

Validate

omarchy plugin validate .
qmllint -I "$OMARCHY_PATH/shell" BarWidget.qml
bash -n control.sh
shellcheck control.sh

Remove

omarchy plugin remove espi.lofi-radio

Stopping the plugin before removal is recommended. Runtime files live under $XDG_RUNTIME_DIR and disappear automatically at logout or reboot. The isolated YouTube login remains in $XDG_STATE_HOME/espi-lofi-radio (or ~/.local/state/espi-lofi-radio) until you remove it manually.

License

MIT. See LICENSE.