Skip to content
This repository was archived by the owner on Jul 7, 2026. It is now read-only.

djinnalexio/eye-on-cursor

 
 

Repository files navigation

Warning

This repository has been migrated and archived

Development has moved to gitlab.gnome.org. This repository is kept for historical reference only and will no longer receive updates.

Static Badge

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

  1. Run the following command to download and install the latest release:

    curl -L https://github.com/djinnalexio/eye-on-cursor/releases/download/v2.4.1/eye-on-cursordjinnalexio.github.io.v23.shell-extension.zip \
    -o /tmp/eye-on-cursor.zip && gnome-extensions install -f /tmp/eye-on-cursor.zip
  2. Log out and back in, then enable the extension using Extensions Manager 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 your GNOME panel that constantly follow your mouse. Mouse tracker included.

Topics

Resources

License

Stars

17 stars

Watchers

1 watching

Forks

Sponsor this project

  •  

Contributors

Languages

  • JavaScript 97.8%
  • Makefile 2.2%