Omahub
← All plugins
O

Mouse

by oxhenri

Pointer input (Setup → Mouse: sensitivity, acceleration, touchpad scroll) and cursor appearance (Style → Cursor: theme and size).

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

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

The plugin is a well-structured settings panel that reads and applies mouse/cursor settings via hyprctl and gsettings, persisting to a dedicated Lua state file. The shell script includes thorough input validation, allowlisting, escaping, atomic writes, and symlink protection, and the QML only passes constrained values. No obfuscation, destructive commands, or credential theft 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/Dev-Herni/oxhenri.mouse --enable
System #system

oxhenri.mouse

Mouse and pointer settings panel for Omarchy (Quickshell).

Two Walker locations, one plugin:

Setup → Mouse — pointer sensitivity, acceleration, touchpad natural scroll and scroll factor

Setup → Mouse

Style → Cursor — cursor theme (hyprcursor and legacy XCursor themes) and cursor size

Style → Cursor

Changes apply immediately via hyprctl and persist through an Omarchy hyprland-toggles lua file (~/.local/state/omarchy/toggles/hypr/oxhenri-mouse.lua) so they survive reloads, in the same way omarchy-hyprland-toggle persists state. Your existing Hyprland config files are never modified.

Install

omarchy plugin add https://github.com/Dev-Herni/oxhenri.mouse.git --enable

Add these lines to ~/.config/omarchy/extensions/omarchy-menu.jsonc so Walker shows Setup → Mouse and Style → Cursor:

"setup.mouse": {"icon":"󰟸","label":"Mouse","action":"omarchy-shell shell summon oxhenri.mouse '{\"view\":\"input\"}'"},
"style.cursor": {"icon":"󰇀","label":"Cursor","action":"omarchy-shell shell summon oxhenri.mouse '{\"view\":\"cursor\"}'"}

A ready-to-merge snippet lives in extras/omarchy-menu.jsonc.

Usage

Open the panel from Walker, or summon it directly:

omarchy-shell shell summon oxhenri.mouse '{"view":"input"}'
omarchy-shell shell summon oxhenri.mouse '{"view":"cursor"}'

Empty payload / missing view opens the input view (backward compatible).

Keyboard: j/k to move between sections, h/l to adjust values, Enter to activate, Esc to close. Mouse input works everywhere too.

Files

  • manifest.json — plugin contract
  • MousePanel.qml — settings UI (input and cursor views)
  • mouse-ctl.sh — read (get) / apply-input / apply-cursor + persist helper
  • extras/omarchy-menu.jsonc — Walker entries under Setup → Mouse and Style → Cursor
  • preview.png — Setup → Mouse
  • screenshots/cursor.png — Style → Cursor

Requirements

Everything used here ships with Omarchy: hyprctl, gsettings, and bash. No extra packages.

Settings are written when you change a value in the panel, and they go to Omarchy's own toggles state dir — your existing Hyprland config files are never modified.

Remove

omarchy plugin remove oxhenri.mouse --yes

Also delete the "setup.mouse" and "style.cursor" lines from ~/.config/omarchy/extensions/omarchy-menu.jsonc if you added them.

Persisted settings live in ~/.local/state/omarchy/toggles/hypr/oxhenri-mouse.lua; delete that file to forget them.

License

MIT — see LICENSE.