Difference between revisions of "Unclutter"

From ArchWiki
Jump to navigation Jump to search
m (→‎Known Bugs: fix capitalization as per Help:Style#Section headings)
(Added unclutter-xfixes as an alternative because unclutter is old, hacky and broken)
Line 4: Line 4:
 
== Installation ==
 
== Installation ==
  
[[pacman|Install]] {{Pkg|unclutter}} from the [[official repositories]].
+
[[pacman|Install]] {{Pkg|unclutter}} from the [[official repositories]] or the modern rewrite {{AUR|unclutter-xfixes-git}} from the [[AUR]].
  
 
== Usage ==
 
== Usage ==
  
Use your ''.xinitrc'' file or WM/DE to start unclutter, for ''.xinitrc'' add:
+
Use your ''.xinitrc'' file or WM/DE to start unclutter. For example, add the following to your ''.xinitrc'':
  
 
  unclutter &
 
  unclutter &
  
If you experience issues when using unclutter in conjunction with a tiling window manager (such as [[xmonad]] or [[i3]]), use the {{ic|-grab}} option:
+
== 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 {{AUR|unclutter-xfixes-git}} instead or use the {{ic|-grab}} option:
  
 
  unclutter -grab &
 
  unclutter -grab &
  
 
{{Note|The {{ic|-grab}} option breaks some screen locking applications such as ''slock'' and ''i3lock''.}}
 
{{Note|The {{ic|-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
 
Unclutter could cause unusual mouse behaviour in some SDL Games. The mouse cursor might be reset to some positions in the screen because of
Line 27: Line 27:
 
There are two known workarounds for this. You can either add {{ic|SDL_VIDEO_X11_DGAMOUSE=0}} to your environment variables which does not work for all games or run unclutter with
 
There are two known workarounds for this. You can either add {{ic|SDL_VIDEO_X11_DGAMOUSE=0}} to your environment variables which does not work for all games or run unclutter with
 
{{ic|-grab}} option. However, it is important to note that the grab option may cause some applications such as gksu to not work properly.
 
{{ic|-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, {{AUR|unclutter-xfixes-git}} can provide the cursor hiding functionality without interfering with any application.
  
 
== See also ==
 
== See also ==
  
 
http://linuxappfinder.com/package/unclutter - Unclutter on Linux App Finder
 
http://linuxappfinder.com/package/unclutter - Unclutter on Linux App Finder

Revision as of 07:37, 12 July 2015

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 or the modern rewrite unclutter-xfixes-gitAUR from the AUR.

Usage

Use your .xinitrc file or WM/DE 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.

See also

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