'\" t
.\"     Title: unclutter-xfixes
.\"    Author: Ingo Bürk
.\" Generator: Asciidoctor 2.0.10
.\"      Date: 2019-10-30
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "UNCLUTTER\-XFIXES" "1" "2019-10-30" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
unclutter\-xfixes \- rewrite of unclutter using the X11\-Xfixes extension
.SH "SYNOPSIS"
.sp
unclutter [\fB\-\-timeout\fP \fIseconds\fP] [\fB\-\-jitter\fP \fIradius\fP] [\fB\-\-exclude\-root\fP] [\fB\-\-ignore\-scrolling\fP] [\fB\-\-fork\fP|\fB\-b\fP] [\fB\-\-help\fP|\fB\-h\fP] [\fB\-\-version\fP|\fB\-v\fP]
.sp
Compatibility arguments:
.sp
unclutter [\fB\-\-display\fP|\fB\-d\fP \fIdisplay\fP] [\fB\-\-idle\fP \fIseconds\fP] [\fB\-\-keystroke\fP] [\fB\-\-grab\fP] [\fB\-\-noevents\fP] [\fB\-\-reset\fP] [\fB\-\-root\fP] [\fB\-\-onescreen\fP] [\fB\-\-not\fP] \fIname …\fP
.SH "OPTIONS"
.sp
\fB\-\-timeout\fP \fIseconds\fP
.RS 4
Specifies the number of seconds after which the cursor should be hidden if
it was neither moved nor any button was pressed. (Default: 5)
.RE
.sp
\fB\-\-jitter\fP \fIradius\fP
.RS 4
Ignore cursor movements if the cursor hasn\(cqt moved sufficiently far.
.RE
.sp
\fB\-\-exclude\-root\fP
.RS 4
Don\(cqt hide the mouse cursor if it is idling over the root window and not an
actual window since in this case it isn\(cqt obscuring anything important, but
rather just the desktop background.
.RE
.sp
\fB\-\-ignore\-scrolling\fP
.RS 4
Ignore mouse scroll events (buttons 4 and 5) so that scrolling doesn\(cqt unhide
the cursor.
.RE
.sp
\fB\-\-fork\fP|\fB\-b\fP
.RS 4
Fork unclutter to the background.
.RE
.sp
\fB\-\-help|\-h\fP
.RS 4
Display the usage and exit.
.RE
.sp
\fB\-\-version\fP|\fB\-v\fP
.RS 4
Display the version and exit.
.RE
.SH "COMPATIBILITY"
.sp
In order to be used as a drop\-in replacement of unclutter, unclutter\-xfixes
accepts all command line arguments of unclutter, but ignores most of them.
.sp
\fB\-\-display\fP|\fB\-d\fP \fIdisplay\fP
.RS 4
Specifies the X display to use. The same effect can be achieved by setting the
\fBDISPLAY\fP environment variable.
.RE
.sp
\fB\-\-idle\fP \fIseconds\fP
.RS 4
This argument is mapped to \fB\-\-timeout\fP.
.RE
.sp
\fB\-\-keystroke\fP
.RS 4
This argument is ignored.
.RE
.sp
\fB\-\-grab\fP
.RS 4
This argument is ignored.
.RE
.sp
\fB\-\-noevents\fP
.RS 4
This argument is ignored.
.RE
.sp
\fB\-\-reset\fP
.RS 4
This argument is ignored.
.RE
.sp
\fB\-\-root\fP
.RS 4
This argument does the opposite of \fB\-\-exclude\-root\fP.
Shouldn\(cqt need to be given, as this is the default behavior in unclutter\-xfixes.
.RE
.sp
\fB\-\-onescreen\fP
.RS 4
This argument restricts unclutter to the single screen specified in \fB\-\-display\fP
or to the default screen of the display.
.RE
.sp
\fB\-\-not\fP
.RS 4
This argument will result in all arguments that aren\(cqt options or option arguments, to be collected
into a list that specifies windows where the cursor shall not be removed. These will be the windows
where an element of the list matches, in a case insensitive comparison, the starting characters of
either the WM_NAME, or the name or class of the WM_CLASS, properties of the window. (Note that this
argument can be given anywhere on the command line.)
.RE
.SH "DESCRIPTION"
.sp
Hide the mouse cursor if it isn\(cqt being used.
.sp
This version of unclutter is a rewrite of the original and uses the x11\-xfixes
extension, which means that no fake windows or pointer grabbing is needed. This
should work better with window managers and applications.
.SH "AUTHOR"
.sp
Ingo Bürk