'\" t
.\"     Title: unclutter-xfixes
.\"    Author: Ingo Bürk
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-03-15
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "UNCLUTTER\-XFIXES" "1" "2024-03-15" "\ \&" "\ \&"
.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\-\-ignore\-buttons\fP \fIbuttons\fP] [\fB\-\-hide\-on\-touch\fP] [\fB\-\-fork\fP|\fB\-b\fP] [\fB\-\-help\fP|\fB\-h\fP] [\fB\-\-version\fP|\fB\-v\fP] [\fB\-\-start\-hidden\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 "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 "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 at least \fIradius\fP pixels.
.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. This is a shortcut for \fB\-\-ignore\-buttons\fP \fI4,5\fP. If you want to
ignore horizontal scrolling as well, use \fB\-\-ignore\-buttons\fP instead by
specifying all buttons manually (e.g. \fI4,5,6,7\fP).
.RE
.sp
\fB\-\-ignore\-buttons\fP
.RS 4
Defines the mouse buttons which do not unhide the cursor when clicked. You can
pass multiple button numbers by separating them with \fI,\fP.
.RE
.sp
\fB\-\-hide\-on\-touch\fP
.RS 4
Hides the mouse cursor on touch events.
.RE
.sp
\fB\-\-start\-hidden\fP
.RS 4
Starts the cursor hidden.
.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 "TROUBLESHOOTING"
.SS "\fB\-\-ignore\-scrolling\fP doesn\(cqt work"
.sp
This can happen, especially on trackpoints, if other button events, e.g. for
horizontal scrolling, are sent as well. You can try adding some jitter, or
verify by using \fBxev \-event button\fP. If you want to ignore horizontal scrolling
as well, use \fB\-\-ignore\-buttons\fP instead of \fB\-\-ignore\-scrolling\fP.
.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 "AUTHOR"
.sp
Ingo Bürk