Unclutter - ArchWiki

Jump to content
From ArchWiki

This article or section is out of date.

Reason: As noted by [1] the package source changed. Description from #unclutter-xfixes should be moved to the intro or a main section accordingly. Perhaps it is useful to create a new #Alternatives subsection for unclutter-patchedAUR along with the switch. (Discuss in Talk:Unclutter)

Unclutter hides your X mouse cursor when you do not need it, to prevent it from getting in the way. You have only to move the mouse to restore the mouse cursor. Unclutter is very useful in tiling window managers where you do not need the mouse often.

## Installation

Install the unclutter package.

Note: Arch actually ships unclutter-xfixes instead of the original in this package.

## Usage

Use your .xinitrc file or Window manager/Desktop environment to start unclutter. For example, add the following to your .xinitrc:

    unclutter &

## Known bugs

### Misbehaviour of the mouse cursor

If you experience issues when using unclutter in conjunction with a tiling window manager (such as xmonad or i3), install unclutter-xfixes-gitAUR instead or use the `-grab` option:

    unclutter -grab &

Note: The `-grab` option breaks some screen locking applications such as slock and i3lock.

Unclutter could cause unusual mouse behaviour in some SDL Games. The mouse cursor might be reset to some positions in the screen because of this problem. The details can be found here.

There are two known workarounds for this. You can either add `SDL_VIDEO_X11_DGAMOUSE=0` to your environment variables which does not work for all games or run unclutter with `-grab` option. However, it is important to note that the grab option may cause some applications such as gksu to not work properly.

## Alternatives

### unclutter-xfixes

Unclutter is a tool from the early 90s and has not been updated since. It works by creating fake windows or active pointer grabs, both of which often cause problems. By now, the X11 extensions Xinput2 and Xfixes have been released and are commonly found on most user systems. Using those, unclutter-xfixes-gitAUR can provide the cursor hiding functionality without interfering with any application.

As of December 2018, community/unclutter will actually ship this rewrite instead of the original[2][3].

### xbanish

xbanish is another tool similar to unclutter, but works in a different way. Instead of using cursor movements, xbanish hides the cursor during typing. You can grab it on the AUR as xbanishAUR or xbanish-gitAUR.

Category:

- X server

Hidden category:

- Pages or sections flagged with Template:Out of date