Omahub
← All plugins
N

Desktop hue

by nzkritik

Tint the whole desktop with a duotone screen shader. Pick a hue from the bar, or turn it off.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

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

The plugin is a straightforward bar widget that applies a duotone screen shader via Hyprland's screen_shader option. The bundled bash script writes shader files to a dedicated directory with atomic writes and symlink safety checks, and only invokes hyprctl to set the shader path. No malicious behavior, obfuscation, or harmful side effects were 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/nzkritik/omarchy-desktop-hue --enable
Appearance #Hyprland #bar #quickshell

Desktop hue

An Omarchy bar widget that tints your entire desktop with a duotone screen shader. Click the palette icon, pick a hue, or drop back to full colour.

The hue list open on the bar

Cycling through hues on the live desktop

Light green on black across the whole desktop

Violet on black across the whole desktop

Black and white, high contrast, across the whole desktop

Because it runs as a Hyprland screen shader (decoration:screen_shader), the tint applies to the final composited frame — every window, browsers, video, games, the bar itself. No per-app configuration.

Requirements

  • Omarchy (Quattro or newer) with omarchy-shell
  • Hyprland with decoration:screen_shader support

Nothing else — the shader script ships in this repo.

Install

omarchy plugin add https://github.com/nzkritik/omarchy-desktop-hue --enable --yes

The widget lands in the bar's right section. Move it with:

omarchy bar move nzkritik.desktop-hue --section center

External dependencies

None. The shader script ships in bin/, and the widget uses only Omarchy's own qs.Ui kit and Hyprland.

Remove

bin/omarchy-monochrome off                  # clear the shader first
omarchy plugin remove nzkritik.desktop-hue

Turning the shader off before removing is worth doing: it clears decoration:screen_shader and deletes the ~/.config/hypr/shaders/current.frag symlink. Removing the plugin while a hue is active would leave your desktop tinted with the plugin gone. If that happens, clear it by hand:

rm -f ~/.config/hypr/shaders/current.frag
hyprctl eval 'hl.config({ decoration = { screen_shader = "[[EMPTY]]" } })'

Generated shaders live in ~/.config/hypr/shaders/monochrome/ and can be deleted freely.

What it writes

Only its own files: generated .frag shaders under ~/.config/hypr/shaders/monochrome/, the current.frag symlink, and decoration:screen_shader set at runtime via hyprctl — each only when you pick a hue. It never edits your Hyprland or Omarchy config files.

Each shader is written to an exclusively created temporary file in that directory and renamed into place, so a write is atomic and never follows a symlink out of the shader directory. A destination that is not a regular file is refused rather than written through.

Use

Click the 󰸌 icon in the bar. The list shows every palette with a colour swatch — the palette's highlight colour ringed by its midtone — and the active one is highlighted. Off (full colour) at the bottom removes the shader.

Arrow keys or j/k move, Enter applies, Esc closes.

While a hue is active the panel and its own swatches are tinted too. That is the shader doing its job on the composited frame, not a rendering bug.

Adding your own hues

The palette table is the single source of truth, and it lives in bin/omarchy-monochrome, not in the QML. Add a row:

# name|label|shadow|mid|highlight|gamma|contrast
"cyan-black|Cyan on black|#000000|#0b5c5c|#2fdede|0.85|1.10"
  • gamma — below 1 lifts midtones, above 1 crushes them
  • contrast — 1.0 is neutral, higher pushes blacks and whites apart

It appears in the bar list on the next open, swatch and all. The widget reads the table via omarchy-monochrome json, so the two can never drift apart.

Command line

The bundled script works standalone:

bin/omarchy-monochrome list              # show palettes
bin/omarchy-monochrome set teal-black    # apply one
bin/omarchy-monochrome set bw 0.5        # half strength
bin/omarchy-monochrome next              # cycle, then off, then round again
bin/omarchy-monochrome off
bin/omarchy-monochrome json              # what the widget reads

Put it on your PATH (e.g. symlink into ~/.local/bin) if you also want a keybinding — the widget prefers a copy on PATH when one exists, so you keep a single install:

-- ~/.config/hypr/bindings.lua
o.bind("SUPER + SHIFT + H", "Cycle desktop hue", "omarchy-monochrome next")

How it works

Panel.qml is a bar-widget built on Omarchy's qs.Ui kit (Panel, BarIconButton, KeyboardPanel, PanelKeyCatcher). Applying a hue generates a fragment shader into ~/.config/hypr/shaders/monochrome/<name>.frag, points ~/.config/hypr/shaders/current.frag at it, and hands that to Hyprland. Turning it off clears the symlink and the shader.

Luminance is measured in linear light and the ramp blended in gamma space, so a neutral black → grey → white palette reproduces the original image's luminance instead of lifting it.

License

MIT — see LICENSE.