https://github.com/arp242/find-cursor

Highlight the cursor position in X11
https://github.com/arp242/find-cursor

x11 x11-cursor

Last synced: 17 days ago
JSON representation

Highlight the cursor position in X11

• Host: GitHub
• URL: https://github.com/arp242/find-cursor
• Owner: arp242
• License: mit
• Created: 2016-10-26T18:48:21.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2024-04-08T16:43:44.000Z (7 months ago)
• Last Synced: 2024-10-13T20:51:00.857Z (about 1 month ago)
• Topics: x11, x11-cursor
• Language: C
• Homepage:
• Size: 146 KB
• Stars: 172
• Watchers: 8
• Forks: 30
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
Simple XLib program to highlight the cursor position. This is similar to the

feature found in Windows XP (and possibly later?)

![screenshot.gif](https://raw.githubusercontent.com/arp242/find-cursor/master/screenshot.gif)

Installation

------------

Compile it by typing `make`, install it with `make install`. There

[packages][pkg] for some platforms as well.

You'll need to install some X11 header files on some systems; e.g. on

Ubuntu/Debian: `libx11-dev`, `libxcomposite-dev`, `libxdamage-dev`, and

`libxrender-dev`. For Fedora 36 you might need to install following:

`libXext-devel`, `libXdamage-devel`, `libXrender-devel`, `libXext-devel`.

There is also a Docker container at [klo2k/find-cursor][d] if you want it. Note

this is NOT maintained (or supported) by me. See #19.

[d]: https://hub.docker.com/r/klo2k/find-cursor

[pkg]: https://repology.org/project/find-cursor/versions

Usage

-----

See `find-cursor -h` to see some options for controlling the appearance.

Launching

---------

You will want to map a key in your window manager to run `find-cursor`. You can

also use [`xbindkeys`](xbindkeys), which should work with `$any` window manager.

I run it with [`xcape`][xcape]:

    xcape -e 'Control_L=Escape;Shift_L=KP_Add'

When `Left Shift` is tapped a `Keypad Add` is sent; I configured my window

manager to launch `find-cursor` with that.

I don't have a numpad on my keyboard; you can also use `F13` or some other

unused key.

You can use a little wrapper script if you want a "toggle" switch for when

repeating forever:

    #!/bin/sh

    if pgrep find-cursor; then

        pkill find-cursor

    else

        find-cursor -r0 &

    fi

Compton

-------

You may want to disable shadows if you use compton or some other composite

manager; for example for compton start it with:

    compton --shadow-exclude "class_g = 'find-cursor'"

Or, perhaps even better, disable it for all shaped windows:

    compton --shadow-exclude 'bounding_shaped'

You can also put that in the compton config file. Other managers might have

different options/flags.

[xcape]: https://github.com/alols/xcape

[xbindkeys]: http://www.nongnu.org/xbindkeys/xbindkeys.html