Omahub
← All plugins
P

Backdrop

by Pierre Berube

Different walls for every display.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

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

The plugin is a straightforward wallpaper manager that writes assignments to a user config file and invokes standard utilities (hyprctl, hyprpicker, wl-paste, python3) for picking images/colors and reading monitor layout. No obfuscation, network calls, destructive commands, or hidden persistence were found; the deterministic scan also reported no issues.

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/lgse/backdrop --enable
Appearance #bar #quickshell #workspaces

Backdrop

Different walls for every display.

Backdrop is a multi-display wallpaper service for the Omarchy Quattro shell. It replaces Omarchy's stock background renderer while preserving the standard background IPC target and global wallpaper fallback.

Backdrop panel showing wallpaper controls for three displays

Current features

  • Manage every connected display from an Omarchy bar widget.
  • Assign a different image to each connected display.
  • Browse backgrounds from every installed stock and user theme.
  • Pick custom image files outside the Omarchy theme library.
  • Assign solid colors using presets, custom hex values, or an on-screen color picker.
  • Use any of the 382 uiGradients presets with a custom angle.
  • Remember displays by manufacturer, model, and serial number when available.
  • Fall back to the connector name and Omarchy's current global background.
  • React to monitor hotplug through Quickshell.screens.

Install

omarchy plugin add https://github.com/lgse/backdrop.git --enable

Plugins run as unsandboxed code inside omarchy-shell. Review third-party plugin code before enabling it.

Use

Click the Backdrop icon in the Omarchy bar. Its panel lists every connected display with five actions:

  • Themes browses backgrounds from all installed Omarchy themes.
  • File opens an isolated native GTK file picker with filesystem navigation and image previews.
  • Solid color offers presets, custom hex colors, and a screen picker powered by hyprpicker.
  • Gradient provides an in-panel, scrollable gallery of all 382 uiGradients, common angle presets, and a custom-angle fallback.
  • Reset returns that display to Omarchy's global background.

Assignments are stored in:

~/.config/omarchy/backdrop/assignments.json

The plugin never modifies files under /usr/share/omarchy.

IPC

Backdrop retains Omarchy's background IPC target and adds these methods:

omarchy-shell -q background setForScreen DP-3 /path/to/wallpaper.png
omarchy-shell -q background setColorForScreen DP-4 '#111318'
omarchy-shell -q background clearForScreen DP-3
omarchy-shell -q background assignments

A serial-backed key shown by assignments is preferred over a connector such as DP-3 because connector names may change.

Compatibility behavior

  • omarchy theme bg set changes the fallback used by displays without an explicit assignment.
  • Theme changes preserve explicit per-display assignments.
  • The lock screen continues to use Omarchy's global current background.
  • Disabling or removing Backdrop restores the stock omarchy.background service.

Roadmap

  • A spatial display-map editor.
  • Group wallpaper results by theme.
  • Optional hyprmoncfg profile and hotplug integration.
  • Profile-specific wallpaper sets.
  • Animated background transitions.

Development

Requirements: Node.js and an installed Omarchy system for QML integration testing.

npm test
omarchy plugin validate .

License

MIT. Gradient names and colors are sourced from the MIT-licensed uiGradients project; see third-party notices.