qol-plugin-os-themes

Configure Linux desktop themes and cursor behavior for qol-tray via xfixes.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/qol-tools/qol-skills --skill qol-plugin-os-themes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qol-plugin-os-themes
Source: https://github.com/qol-tools/qol-skills/tree/main/plugins/qol-plugin-os-themes/skills/qol-plugin-os-themes
Command: npx skills add https://github.com/qol-tools/qol-skills --skill qol-plugin-os-themes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps qol-tray OS theming coherent across the desktop by providing a centralized mechanism to manage cursor behavior, theme wiring, and daemon lifecycle.

Core Features & Use Cases

  • Shake-to-grow cursor: detect rapid cursor movement and scale the pointer, with smooth transitions.
  • X11 cursor manipulation via xfixes: apply and restore cursor images programmatically.
  • Daemon lifecycle: run as a background service with a socket interface for runtime control.
  • GTK/Qt/icon theming roadmap: outlines plans to extend theme swaps across GTK, Qt, and icon sets.

Quick Start

Launch the qol-plugin-os-themes daemon and enable the Cursor Grow option in the settings.

Frequently Asked Questions about qol-plugin-os-themes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure OS-wide themes and cursor behavior on Linux?

You configure OS-wide themes and cursor behavior on Linux by launching the qol-plugin-os-themes daemon and enabling desired options like Cursor Grow in the settings. It provides a centralized mechanism for managing cursor behavior and theme wiring.

How does the shake-to-grow cursor feature work?

The shake-to-grow cursor feature detects rapid cursor movement and scales the pointer accordingly, providing smooth visual transitions. This helps locate the cursor quickly through dynamic scaling based on movement velocity.

Does this cursor manipulation tool work on Wayland or is it X11 only?

This cursor manipulation tool is Linux-only and relies specifically on X11 cursor control via xfixes. It enforces a platform constraint requiring X11, as xfixes is used to apply and restore cursor images programmatically.

How do I control the cursor theme daemon at runtime?

You control the cursor theme daemon at runtime through a provided socket interface. The daemon runs as a background service, and this socket allows you to send commands to manage the daemon lifecycle and apply settings dynamically.

Are there limitations to the GTK and Qt theming support?

GTK, Qt, and icon theming support is currently a roadmap item, meaning it is planned but not fully implemented. The current limitations restrict functionality primarily to X11 cursor manipulation and shake-to-grow effects.

What is the best way to manage xfixes cursor images programmatically in a tray application?

The best way to manage xfixes cursor images programmatically is using a centralized daemon with a socket interface. This approach handles applying and restoring cursor images while maintaining theme coherence across the desktop.