Omahub
← All plugins
K

Terminal Wallpaper

by Kevin Knapp

Run a terminal wallpaper on top of your existing wallpaper. Double-click wallpaper to configure.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
06d53b7
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

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
06d53b7
Reviewed
1 month ago

The plugin runs a user-configured command inside a VTE terminal rendered as a wallpaper, which is its intended purpose. The code is straightforward, uses safe file operations with proper quoting and O_NOFOLLOW, and contains no obfuscation, persistence, or credential theft. The only risk is that it executes arbitrary commands, but those are explicitly set by the user via the config menu or IPC.

  • The plugin executes a user-specified shell command in a terminal; this is the core feature and requires the user to trust the command they configure.
  • Settings are written via a bash command, but paths and JSON are properly shell-quoted, so injection is not evident.
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/knappkevin/terminal-wallpaper --enable
Appearance #system

Terminal Wallpaper Plugin for Omarchy

Run a terminal wallpaper on top of your existing desktop wallpaper. Double-click the wallpaper to configure the terminal output.

Features

  • Double-click to configure
  • Terminal color palette and backgrounds hot-swap with theme switch
  • Terminal output overlays onto theme wallpaper

donut

Install

omarchy pkg add vte3 gtk-layer-shell python-gobject

omarchy plugin add https://github.com/knappkevin/terminal-wallpaper.git --enable

Example Pictures Here

Example Commands

Omarchy screensaver overlay

while true; do ttfx -i ~/.config/omarchy/branding/screensaver.txt --frame-rate 60 --canvas-width 0 --canvas-height 0 --reuse-canvas --anchor-canvas c --anchor-text c --random-effect --no-eol --no-restore-cursor; done

Know the risks of downloading from aur

fastfetch                       # larp
btop                            # system monitor TUI
journalctl -f -n 40 --no-pager -o short   # live log
cmatrix                         # matrix rain
donut                           # from aur donut.c
asciiquarium --transparent      # from aur asciiquarium-git
cbonsai -li                     # from aur cbonsai
game of life                    # from idk

Runtime IPC

omarchy-shell terminal-wallpaper open         # open config menu
omarchy-shell terminal-wallpaper close
omarchy-shell terminal-wallpaper toggle
omarchy-shell terminal-wallpaper refresh      # restart the terminal
omarchy-shell terminal-wallpaper setCommand 'fastfetch'   # change command

Remove

omarchy plugin remove knappkevin.terminal-wallpaper