Skip to content

djinnalexio/eye-on-cursor

 
 

Repository files navigation

Eye on Cursor

GitHub License Latest Release

GNOME versions GNOME Downloads

logo

Let your desktop "keep an eye" on your mouse!

Overview

Eye on Cursor is a fun and practical extension that gives your panel eyes that constantly follow your mouse. This quirky feature, combined with a highly customizable mouse tracker that highlights clicks, makes it easier than ever to monitor your mouse movements, ensuring your pointer gets all the attention it needs.

Features

  • Eyes Follow Cursor: As many eyes as you want in the panel to follow the cursor movements, providing a fun and interactive experience.
  • Customizable Mouse Tracker: Highlights clicks and tracks mouse movements with customizable settings to fit your preferences.

Installation

From the GNOME Extensions Website (recommended)

EGO page

From GitHub

⚠️ Note: When installing this extension manually from GitHub, it will not receive automatic updates from the GNOME Extensions website.

  1. Go to the latest release and download the extension zip file.

  2. At the location of the downloaded zip file, run the install command:

    gnome-extensions install --force eye-on-cursor@djinnalexio.github.io.shell-extension.zip
  3. Log out of your session and log back in, then enable the extension using your Extensions manager app or by running:

    gnome-extensions enable eye-on-cursor@djinnalexio.github.io

Acknowledgements

This extension is forked from Eye and Mouse Extended by Alexey Lovchikov.

Eye and Mouse Extended also has a fork for the Cinnamon Desktop, Cinnamon Eyes, created by anaximeno.

Contributing

First off, thanks for taking the time to contribute! ❤️

If you want to ask a question, offer a suggestion, or report a bug, feel free to open an issue.

You can also submit pull requests to provide translations, new tracker icons, or bug fixes.

If you have contributed in any way, feel free to add yourself to the about.js file in settings.

Known Issues

  • On Wayland, the mouse tracker uses globe.stage to listen to clicks:

    • clicks within application windows are not registered. Only clicks in the Shell (background, panel, etc.) are highlighted.
  • On x11, the mouse tracker uses Atspi listen to clicks:

    • middle click is not registered.

Resources

About

👁️ Add eyes to you GNOME panel that constantly follow your mouse. Mouse tracker included.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors

Languages

  • JavaScript 97.9%
  • Makefile 2.1%