mirror of https://github.com/arp242/find-cursor
parent
222db0fb4d
commit
fcc5cb2534
@ -1,11 +1,12 @@
|
||||
CC?=cc
|
||||
CFLAGS?=-std=c99 -pedantic -Wall -Os
|
||||
STRIP?=strip
|
||||
PREFIX?=/usr
|
||||
PREFIX?=/usr/local
|
||||
MANPREFIX?=$(PREFIX)/share/man
|
||||
|
||||
all:
|
||||
${CC} ${CFLAGS} ${LDFLAGS} -o find-cursor find-cursor.c -lX11 -lXext -lXfixes
|
||||
|
||||
install:
|
||||
$(STRIP) find-cursor
|
||||
install -Dm755 find-cursor $(DESTDIR)$(PREFIX)/bin/find-cursor
|
||||
sed "s/VERSION/`git tag | tail -1 | tr -d v`/g" < find-cursor.1 > $(DESTDIR)$(MANPREFIX)/man1/find-cursor.1
|
||||
chmod 644 $(DESTDIR)$(MANPREFIX)/man1/find-cursor.1
|
||||
|
@ -0,0 +1,104 @@
|
||||
.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 ]
|
||||
.SH DESCRIPTION
|
||||
|
||||
.B find-cursor
|
||||
highlights the cursor position by drawing circiles around them.
|
||||
.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
|
||||
following the cursor position, but it doesn't work well with all WMs, which is
|
||||
why it's disabled by default.
|
||||
.TP
|
||||
\fB-w\fR, \fB--wait\fR \fI\,MICROSECONDS\/\fR
|
||||
Time to wait before drawing the next circle.
|
||||
.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
|
||||
.SH LAUNCHING
|
||||
|
||||
.PP
|
||||
You will want to map a key in your window manager to run \fIfind-cursor\fR. You
|
||||
can also use \fIxbindkeys\fR, which should work with $any window manager.
|
||||
.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
|
||||
https://github.com/Carpetsmoker/find-cursor
|
Loading…
Reference in New Issue