Modern take on the classic neko desktop pet for X11. Works on Wayland through XWayland.

Unlike the original oneko, strayneko doesn't constantly chase your mouse cursor. Instead, it wanders around your desktop on its own.

Originally created for personal use, but shared in case someone else finds it useful or enjoyable.

Features

• Autonomous wandering
• Random spawn position
• Zoomies mode
• Optional draggable bed with saved position
• Configurable idle time between walks
• Multi-monitor support
• Optional monitor restriction

Installation

From a release (recommended)

Download the latest release, extract the archive, and run:

./install.sh

The installer will automatically install the binary, desktop entry, application icon, man page, and uninstaller.

To uninstall strayneko later, simply run:

strayneko-uninstall

---

Build from source

git clone https://github.com/excommeownicado/strayneko.git
cd strayneko

cmake -B build
cmake --build build

For developers

To enable developer-only options and debug logging, build with:

cmake -B build \
      -DCMAKE_BUILD_TYPE=Debug \
      -DENABLE_DEBUG=ON

cmake --build build

To install system-wide:

sudo cmake --install build

Usage

Simply execute strayneko to go with a default look and behavior. For customization use the following command-line arguments.

Available command-line options:

• --fg – changes the color of neko's outline
• --bg – changes the color of neko's body
• --bed – shows a draggable bed that neko may occasionally visit
• --min-wait – sets the minimum idle time between walks
• --max-wait – sets the maximum idle time between walks
• --speed – sets neko's movement speed
• --time – sets the interval between animation frames
• --monitor – restricts neko to a specified monitor

Developer options

If debug mode is enabled (only available through building from source):

• --debug – enables debug log output
• --force-target – forces neko to move toward the specified coordinates

Examples

strayneko --monitor 0 --bed
strayneko --min-wait 10 --max-wait 100

Credits

This project is based on oneko 1.2.sakura.5.

Original project:
http://www.daidouji.com/oneko/

See CREDITS for full attribution.

License

This fork is released under the MIT License. See the LICENSE file for details.

The original upstream code includes portions that are Public Domain; where applicable, original authors' public-domain notices are preserved in the source and credits.

Note

This project is an independent fork and is not affiliated with the original authors.