____ ____ ___ / /______ / __ \__ __
/ __ \/ __ \/ _ \/ //_/ __ \/ /_/ / / / /
/ /_/ / / / / __/ ,< / /_/ / ____/ /_/ /
\____/_/ /_/\___/_/|_|\____/_/ \__, /
/____/
A Python-based virtual desktop cat that follows your cursor—with extra features and modes for more interactivity!
The latest update introduces:
✅ A draggable feeder in Chill Mode
✅ An improved eating cycle where the cat sleeps until every 5 minutes when it moves, "eats," and returns to its spot
- The cat follows your mouse cursor across the screen.
- The cat stays idle (in a sleeping state) but can be repositioned via drag-and-drop.
- The cat remains in a sleeping pose without random movement.
- Every 5 minutes, an eating cycle is triggered:
- The cat moves smoothly to a draggable feeder.
- Performs an eating animation for ~5 seconds.
- Returns precisely to its original sleeping spot.
- Easily switch between modes or exit the application via a tray icon.
- In Wait and Chill modes, you can manually reposition the cat (and the feeder in Chill mode).
- The cat occasionally performs idle animations in Follow Mode.
- Optional logging helps troubleshoot behavior and verify resource loading.
- Designed to be compiled into a standalone executable for Windows.
- Go to Releases.
- Download the latest version.
- Run it! 🎉
Ensure you have Python 3 installed along with the following dependencies:
pip install pyautogui PyQt5To start the cat, simply run:
python main.pyIf you want to compile it as an executable (optional):
pip install pyinstaller
pyinstaller --onefile --windowed --add-data "oneko.gif;." --add-data "gatito.ico;." --add-data "feeder.png;." --icon=gatito.ico main.pyThis will create an executable in the dist folder.
Upon running, the cat will appear on your screen and start following your mouse. You can change its behavior via the system tray menu.
- Right-click on the tray icon to switch modes or exit the program.
- Left-click and drag the cat when in wait/chill mode.
Want a different look? Replace these files with your own images:
- oneko.gif (cat sprite)
- gatito.ico (icon)
- feeder.png (feeder)
⚠️ Ensure images maintain the correct dimensions (e.g., the sprite sheet should be 256×128 pixels).
This project is open-source and available under the MIT License.
Enjoy your virtual pet! 🐱