plasma-apply-cursortheme
Apply a cursor theme in Plasma
TLDR
List available cursor themes
Apply a cursor theme
Display help
SYNOPSIS
plasma-apply-cursortheme [THEME]
PARAMETERS
THEME
Name of the cursor theme to apply (e.g., Breeze).
-h, --help
Display usage information and exit.
-v, --version
Display version information and exit.
DESCRIPTION
The plasma-apply-cursortheme command is a utility in the KDE Plasma desktop environment designed to change the active mouse cursor theme without requiring a logout, reboot, or Plasma session restart. It updates the X11 cursor settings across running applications by modifying the relevant configuration and signaling the window manager.
Usage involves specifying the name of an installed cursor theme, such as 'Breeze', 'oxygen', or 'Adwaita'. The command scans system icon directories (e.g., /usr/share/icons) for the theme and applies it if found. This is particularly useful for testing themes, scripting theme switches, or applying changes from package managers.
It works by updating kwin_x11 and Plasma shell configurations, then propagating changes via Xresources or DBus. Note that Wayland sessions may have limited support, as cursor theming behaves differently. Requires Plasma workspace packages and root privileges are not needed for user sessions.
CAVEATS
Requires theme installed in icon directories; Wayland support limited; may not affect all Qt/GTK apps immediately; run in Plasma X11 session for best results.
EXAMPLES
Apply Breeze theme:
plasma-apply-cursortheme Breeze
List available themes:
ls /usr/share/icons | grep -E 'cursors|Cursor'
Apply with full check:
plasma-apply-cursortheme && qdbus org.kde.KWin /KWin reconfigure
HISTORY
Introduced in KDE Plasma 5.0 (2014) as part of plasma-workspace package; evolved in Plasma 5.x and Plasma 6 for better theming support; developed by KDE team for dynamic UI customization.
SEE ALSO
kwriteconfig5(1), plasma-apply-desktoptheme(1), kcmshell6(1)


