Omahub
← All plugins
T

Cursor Style

by taxin-404

Pick the cursor theme and size

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

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

This plugin provides a cursor theme and size picker for Omarchy. It modifies user configuration files (Hyprland, GTK) and runs hyprctl to apply changes, but only when the user explicitly selects a theme or size. The code is transparent, uses standard tools, and includes tests. No malicious or suspicious behavior detected.

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/taxin-404/oma-cursor-style --enable
Appearance #quickshell #launcher #system

oma-cursor-style

A self-contained Omarchy plugin that picks the cursor theme and size from a single overlay picker.

Everything the picker needs is bundled in this plugin: the QML overlay, the cursor discovery/apply scripts under bin/, and the tests under test/. There is no dependency on Omarchy source — any Omarchy user can install it.

License: MIT.

Features

  • Searchable overlay (themed like the menu) with Theme / Size modes (Tab to switch).
  • Lists Hyprcursor and legacy X11 cursor themes from system and user icon dirs, and standard sizes — plus a Custom size entry that prompts for any value in pixels.
  • Applies instantly via hyprctl setcursor, persists hl.env in hyprland.lua, and keeps GTK settings.ini / gsettings in sync.
  • Falls back gracefully on systems without the Omarchy runtime (no notification/hook, no crash).

Installation

omarchy plugin add https://github.com/taxin-404/oma-cursor-style.git
omarchy plugin enable taxin.cursor-style

Enabling the plugin self-installs a Style › Cursor Style row into ~/.config/omarchy/extensions/omarchy-menu.jsonc, so the picker is reachable from the Omarchy menu with no manual config. The row lives in your user config (not the shipped defaults), so it survives Omarchy upgrades. Disabling or removing the plugin takes the row back out automatically, and re-enabling restores it. The row's action points at a companion entry script copied into the same extensions directory, so a row that is ever left behind cleans itself up the next time it is clicked.

Uninstalling

omarchy plugin remove taxin.cursor-style --yes

This disables the plugin, removes it from the shell, and deletes its menu row from the user menu extension. If a row is ever left behind, remove it manually:

omarchy-cursor-menu-install --remove

Dependencies

Runtime requirements, all standard on an Omarchy desktop:

  • Hyprland — applies the cursor via hyprctl setcursor and persists the choice in hl.env inside hyprland.lua.
  • GTK toolset — keeps settings.ini / gsettings in sync with the theme and size.
  • Omarchy runtime — omarchy-menu-input, omarchy-notification-send, and omarchy-hook provide the size prompt and apply notifications.
  • Hyprcursor / X11 cursor themes — listed from system and user icon dirs.

Nothing external is vendored, and the plugin degrades gracefully (no notifications, no crash) when the Omarchy runtime is absent. Cursor themes themselves are not bundled; install the themes you want from your distro.

What the plugin writes

Enabling the plugin only adds one row to the user menu extension (~/.config/omarchy/extensions/omarchy-menu.jsonc); it never overwrites an existing row or any other user configuration. Applying a theme or size changes the cursor settings (hl.env, GTK settings.ini / gsettings) — and only happens when you explicitly pick a theme or type a size. Enabling or disabling the plugin itself never changes your cursor.

Usage

Summon the picker:

omarchy-shell shell toggle taxin.cursor-style

Standalone scripts

The bin/ scripts work without the plugin or the Omarchy CLI. They resolve their sibling helpers by script location, so the repo can be cloned anywhere:

bin/omarchy-cursor-list              # installed themes
bin/omarchy-cursor-current           # current theme
bin/omarchy-cursor-set <name>        # apply + persist a theme
bin/omarchy-cursor-size-list         # standard sizes
bin/omarchy-cursor-size-current      # current size
bin/omarchy-cursor-size-set <px>     # apply + persist a size
bin/omarchy-cursor-size-custom       # prompt for any size and apply it
bin/omarchy-cursor-menu-install      # ensure the Style > Cursor Style menu row
bin/omarchy-cursor-menu-install --remove  # take the row back out
bin/omarchy-cursor-menu-entry        # row action: open the picker or self-clean
bin/omarchy-cursor-open              # open the picker (needs the plugin)

Layout

manifest.json       plugin manifest (id taxin.cursor-style, overlay)
CursorStyle.qml     overlay entry point
bin/                cursor scripts (self-contained)
test/               standalone test suite

Development

Validate the plugin folder with the Omarchy validator (or inspect test/validate.sh):

omarchy plugin validate .
./test/cursor-style-test.sh