Unclutter - ArchWiki

# Unclutter

This article is a stub.

Notes: please use the first argument of the template to provide more detailed indications. (Discuss)

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 unclutter from the official repositories.

## Usage

Use your .xinitrc file or WM/DE to start unclutter, for .xinitrc add:

    unclutter &

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

    unclutter -grab &

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

## Known Bugs

### Misbehaviour of the mouse cursor

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.

## See also

http://linuxappfinder.com/package/unclutter - Unclutter on Linux App Finder

Category:

- X Server