works for both Linux (Hyprland) and Windows.
Cato is a tiny desktop cat that lives on your screen and follows your mouse cursor. It walks, runs, idles with different animations, and stays pinned above all your windows without stealing focus.
considering more animations and interactions .
| Arch | idk_lol |
|---|---|
![]() |
![]() |
| Licking | Running |
![]() |
![]() |
- Go
- Hyprland ( for other DE's future maybe)
- Go
- Windows 10/11
Add the following window rules to your Hyprland config:
hl.window_rule({match = {title = "^(cato)$"}, no_focus = true})
hl.window_rule({match = {title = "^(cato)$"}, float = true})
hl.window_rule({match = {title = "^(cato)$"}, pin = true})
hl.window_rule({match = {title = "^(cato)$"}, no_shadow = true})
hl.window_rule({match = {title = "^(cato)$"}, no_blur = true})
hl.window_rule({match = {title = "^(cato)$"}, no_initial_focus = true})
hl.window_rule({match = {title = "^(cato)$"}, no_anim = true})
hl.window_rule({match = {title = "^(cato)$"}, move = {0, 0}})Reload Hyprland after adding the rules.
hyprctl reload
no configs required
git clone https://github.com/HASSAAN-AMIN/cato
cd cato
chmod +x run.sh
./run.sh
or :
go run .
or :
go build -o cato
./cato
run.bat
Or:
go run .
it uses Go build tags to identify the OS and build according to that
linux.go→ Linux (Hyprland)windows.go→ Windows
Contributions are always welcome!!!!!!!!!!!
If you'd like to add new animations, behaviors, features, improve the codebase, or fix bugs, feel free to open a pull request.
I'd especially love contributions that make Cato work on more Linux distributions and desktop environments, not just the current Arch Linux + Hyprland setup.
also contribuitions for MacOS support



