LinuxCommandLibrary

unclutter

Auto-hide idle mouse cursor on X11

TLDR

Hide cursor after idle

$ unclutter
copy
Custom timeout
$ unclutter -idle [3]
copy
Ignore window
$ unclutter -not [window-name]
copy
Run in background
$ unclutter -b
copy
Don't touch root window
$ unclutter -noevents
copy

SYNOPSIS

unclutter [-idle seconds] [-b] [options]

DESCRIPTION

unclutter automatically hides the mouse cursor on X11 desktops after a configurable period of inactivity. When the user moves the mouse, the cursor immediately reappears, making the hiding completely transparent during normal use.
The tool is particularly useful for presentations, kiosk displays, and keyboard-focused workflows where a stationary mouse pointer is a visual distraction. It can run as a background daemon and supports excluding specific windows from cursor hiding, allowing the cursor to remain visible in applications that need it.
Two main implementations exist: the original X11 version and unclutter-xfixes, which uses the XFixes extension for a more modern approach. Both serve the same purpose but differ in implementation details and compatibility with compositing window managers.

PARAMETERS

-idle SEC

Seconds before hide.
-b
Background daemon.
-not NAME
Ignore window.
-noevents
No root events.
-display DPY
X display.

CAVEATS

X11 only. Multiple versions exist. May conflict with apps.

HISTORY

unclutter was created to hide the mouse cursor when it's not being used, cleaning up the X11 display.

SEE ALSO

xdotool(1), xsetroot(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community