Omahub
← All plugins
D

Screen Wash

by Daan

Periodically washes the screen with colors or dim overlay to prevent burn-in during long sessions.

GitHub

Security review

Review recommended · 1 finding

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
8453618
Scanned
1 month ago

Flagged patterns appear only in documentation files (README / docs) — descriptive examples, not executable code.

  • Docs external_hosts README.md:51

    Downloads or connects to an external HTTP(S) host.

    git clone https://github.com/Deunnis/omarchy-screenwash.git ~/.config/omarchy/plugins/daan.screenwash

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
8453618
Reviewed
1 month ago

The deterministic scan's only finding is a git clone command in README.md, which is documentation for manual installation and is not executed by the plugin. The runtime code is a straightforward QML overlay service that uses fixed hyprctl/kill commands for fullscreen detection and draws colored/dim overlays; no obfuscation, persistence, credential access, 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/Deunnis/omarchy-screenwash --enable
System #quickshell #system

Screen Wash — Omarchy Burn-In Prevention Plugin

Periodically washes the screen with cycling solid colors or dims it to prevent burn-in during long sessions.

Screen Wash Popup

Install / Remove

omarchy plugin add Deunnis/omarchy-screenwash

omarchy plugin remove daan.screenwash

Features

  • Two wash modes: wash (cycles through R→G→B→white) and dim (fades a black overlay)
  • Click the monitor icon (󰍹) in the bar to open the settings popup
  • Toggle on/off, switch mode, set interval and duration — all from the popup
  • Automatically skips wash when a fullscreen window is active
  • Persistent settings across restarts

Wash Animation

Settings

All settings can be changed from the bar popup menu:

Setting Options Default Description
Mode Wash / Dim Wash Wash cycles solid colors; dim fades a black overlay
Interval 15m / 30m / 60m / 120m 30m Minutes between screen washes
Duration 0.5s / 1s / 1.5s / 3s 1.5s How long the wash overlay stays visible
Skip if fullscreen On / Off On Skip the wash if a fullscreen window is active

IPC Commands

omarchy shell daan.screenwash trigger

omarchy shell daan.screenwash status

Manual Installation

git clone https://github.com/Deunnis/omarchy-screenwash.git ~/.config/omarchy/plugins/daan.screenwash

Then add { "id": "daan.screenwash" } to both the plugins array and the bar layout in ~/.config/omarchy/shell.json.

Manual Removal

rm -rf ~/.config/omarchy/plugins/daan.screenwash

Then remove { "id": "daan.screenwash" } from the plugins array and bar layout in ~/.config/omarchy/shell.json.

License

MIT — see LICENSE.