2019-03-04 21:46:26 +00:00
|
|
|
.TH FIND-CURSOR 1 find-cursor\-VERSION
|
|
|
|
|
.SH NAME
|
|
|
|
|
find-cursor \- highlight the cursor position
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B find-cursor
|
|
|
|
|
.RB [ \-fghto ]
|
|
|
|
|
.RB [ \-s
|
|
|
|
|
.IR size ]
|
|
|
|
|
.RB [ \-d
|
|
|
|
|
.IR distance ]
|
|
|
|
|
.RB [ \-l
|
|
|
|
|
.IR line-width ]
|
|
|
|
|
.RB [ \-w
|
|
|
|
|
.IR wait ]
|
|
|
|
|
.RB [ \-c
|
|
|
|
|
.IR color ]
|
2019-12-04 20:22:27 +00:00
|
|
|
.RB [ \-r
|
|
|
|
|
.IR repeat ]
|
2019-03-04 21:46:26 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
|
|
|
|
|
.B find-cursor
|
2020-03-30 11:31:41 +00:00
|
|
|
highlights the cursor position by drawing circles around them.
|
2019-03-04 21:46:26 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
|
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-c\fR, \fB\-\-color\fR \fI\,CODE\/\fR
|
|
|
|
|
Color; can either be an X11 color name or RGB as hex.
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-d\fR, \fB\-\-distance\fR \fI\,PIXELS\/\fR
|
|
|
|
|
Distance between the circles in pixels.
|
|
|
|
|
.TP
|
|
|
|
|
\fB-f\fR, \fB--follow\fR
|
|
|
|
|
Follow the cursor position as the cursor is moving.
|
|
|
|
|
.TP
|
|
|
|
|
\fB-g\fR, \fB--grow\fR
|
|
|
|
|
Grow the animation in size, rather than shrinking it.
|
|
|
|
|
.TP
|
|
|
|
|
\fB-h\fR, \fB--help\fR
|
|
|
|
|
Show help.
|
|
|
|
|
.TP
|
|
|
|
|
\fB-l\fR, \fB--line-width\fR \fI\,PIXELS\/\fR
|
|
|
|
|
Width of the lines.
|
|
|
|
|
.TP
|
|
|
|
|
\fB-o\fR, \fB--outline\fR
|
|
|
|
|
Draw an outline in the opposite color as well. Helps visibility on all
|
|
|
|
|
backgrounds.
|
|
|
|
|
.TP
|
|
|
|
|
\fB-s\fR, \fB--size\fR \fI\,PIXELS\/\fR
|
|
|
|
|
Maximum size the circle will grow to.
|
|
|
|
|
.TP
|
|
|
|
|
\fB-t\fR, \fB--transparent\fR
|
|
|
|
|
Make the window truly 'transparent'. This helps with some display issues when
|
2020-03-30 12:32:53 +00:00
|
|
|
following the cursor position, but it doesn't work well with all window
|
|
|
|
|
managers, which is why it's disabled by default.
|
2019-03-04 21:46:26 +00:00
|
|
|
.TP
|
2020-03-30 12:32:53 +00:00
|
|
|
\fB-w\fR, \fB--wait\fR \fI\,TIME\/\fR
|
|
|
|
|
Time to wait before drawing the next circle, in tenths of milliseconds.
|
2019-12-04 20:22:27 +00:00
|
|
|
.TP
|
|
|
|
|
\fB-r\fR, \fB--repeat\fR \fI\,N\/\fR
|
|
|
|
|
Number of times to repeat the animation. Use 0 to repeat indefinitely.
|
2019-03-04 21:46:26 +00:00
|
|
|
.SH EXAMPLES
|
|
|
|
|
|
|
|
|
|
.PP
|
|
|
|
|
The defaults:
|
|
|
|
|
.RS
|
|
|
|
|
find-cursor --size 320 --distance 40 --wait 400 --line-width 4 --color black
|
|
|
|
|
.RE
|
|
|
|
|
.PP
|
|
|
|
|
Draw a solid circle:
|
|
|
|
|
.RS
|
|
|
|
|
find-cursor --size 100 --distance 1 --wait 20 --line-width 1
|
2019-12-04 20:22:27 +00:00
|
|
|
.RE
|
|
|
|
|
.PP
|
|
|
|
|
Always draw a full circle on top of the cursor:
|
|
|
|
|
.RS
|
|
|
|
|
find-cursor --repeat 0 --follow --distance 1 --wait 1 --line-width 16 --size 16
|
2019-03-04 21:46:26 +00:00
|
|
|
.SH LAUNCHING
|
|
|
|
|
|
|
|
|
|
.PP
|
|
|
|
|
You will want to map a key in your window manager to run \fIfind-cursor\fR. You
|
2020-03-30 12:32:53 +00:00
|
|
|
can also use \fIxbindkeys\fR, which should work with any window manager.
|
2019-03-04 21:46:26 +00:00
|
|
|
.PP
|
|
|
|
|
I run it with \fIxcape\fR:
|
|
|
|
|
.RS
|
|
|
|
|
xcape -e 'Control_L=Escape;Shift_L=KP_Add'
|
|
|
|
|
.RE
|
|
|
|
|
.PP
|
|
|
|
|
When
|
|
|
|
|
.B
|
|
|
|
|
Left Shift
|
|
|
|
|
is tapped a
|
|
|
|
|
.B
|
|
|
|
|
Keypad Add
|
|
|
|
|
is sent; I configured my window manager to launch
|
|
|
|
|
.I
|
|
|
|
|
find-cursor
|
|
|
|
|
with that.
|
|
|
|
|
.PP
|
|
|
|
|
I don't have a numpad on my keyboard; you can also use
|
|
|
|
|
.B
|
|
|
|
|
F13
|
|
|
|
|
or some other unused key.
|
|
|
|
|
.SH AUTHORS
|
|
|
|
|
|
|
|
|
|
.PP
|
|
|
|
|
Martin Tournoij <martin@arp242.net>
|
|
|
|
|
.PP
|
|
|
|
|
The MIT license applies. See
|
|
|
|
|
.I
|
|
|
|
|
LICENSE
|
|
|
|
|
in the source distribution.
|
|
|
|
|
.PP
|
|
|
|
|
.I
|
2019-12-04 20:22:27 +00:00
|
|
|
https://github.com/arp242/find-cursor
|
