Omahub
← All plugins
C

Screen Zoom

by chuma-beep

Zoom the entire screen in and out in smooth steps around the mouse cursor. Topbar icon opens +/− controls with a live percentage and one-click reset.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

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

The plugin is a straightforward screen zoom widget that interacts with Hyprland's cursor:zoom_factor via hyprctl. The code is clear, non-obfuscated, and contains no destructive or credential-harvesting behavior. The only minor concern is the opt-in IPC feature, which is disabled by default and documented as allowing any local process to control zoom when enabled.

  • The IPC handler exposes zoomIn/zoomOut/reset commands to any local process when 'Allow IPC commands' is enabled, but this is disabled by default and clearly documented.
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/chuma-beep/omarchy-screen-zoom --enable
Widgets #Hyprland #bar #system

Screen Zoom for Omarchy

A topbar widget that magnifies your entire screen in smooth steps, centered on your mouse cursor. Handy for presentations, reading small text, pixel work, or accessibility.

Powered by Hyprland's native cursor:zoom_factor engine — no external magnifier tools, no re-compositing, instant and smooth.

preview

Features

  • Magnifier icon in the topbar — shows the current zoom percentage while zoomed (e.g. 125%), a glyph at 100%
  • Click to open controls — big − Out / + In buttons, a live percentage readout, and one-click Reset to 100%
  • Smooth 25% steps by default (configurable), clamped to a 400% maximum
  • Stays in sync — zoom with your keyboard (SUPER+CTRL+Z) and the widget label follows along within two seconds
  • Works everywhere: zoom follows your cursor across all monitors
  • IPC scriptable (opt-in): enable Allow IPC commands to drive zoom from scripts and keybinds — omarchy-shell wisdom.screen-zoom zoomIn|zoomOut|reset|toggle

Requirements

  • Omarchy Quattro (or any Omarchy with the Quickshell-based shell)
  • Hyprland 0.56+ for the modern Lua config bridge. Older Hyprland versions are auto-detected and served via the legacy hyprctl keyword path.

Install

omarchy plugin add https://github.com/chuma-beep/omarchy-screen-zoom.git

Then add the Screen Zoom widget to your bar when prompted (defaults to the right section), or move it later with omarchy bar move wisdom.screen-zoom --section right.

Usage

Action How
Zoom in / out Click the icon, use + In / − Out
Reset to 100% Click Reset to 100%
Keyboard (built-in Omarchy binds) SUPER+CTRL+Z in, SUPER+CTRL+ALT+Z reset
Script / keybind Enable Allow IPC commands first, then omarchy-shell wisdom.screen-zoom zoomIn (also zoomOut, reset; open, close, toggle always manage the popup)

Configuration

Right-click the widget in your bar (or open Setup → Plugins → Screen Zoom) to configure:

Setting Default Description
Step size (%) 25 How much each click changes magnification (5–100)
Maximum zoom (%) 400 Upper clamp for + and zoomIn (150–800)
Bar icon Nerd Font glyph shown at 100% zoom
Allow IPC commands Off Lets scripts and keybinds change zoom via omarchy-shell. While on, any local process can invoke these commands.

How it works

The widget talks directly to the Hyprland compositor (cursor:zoom_factor) using the IPC instance it discovers at startup — including sessions where HYPRLAND_INSTANCE_SIGNATURE isn't propagated to the shell (common under uwsm). On Hyprland 0.56+ it uses the Lua config bridge; older versions get the legacy keyword command automatically.

Security notes

Zoom changes coming from outside the widget (scripts, keybinds) are disabled by default. Shell IPC is reachable by every process running as your user, so enable Allow IPC commands only if you want scripted control of the zoom factor. The widget's own buttons and popup never require the opt-in.

License

MIT © chuma-beep