Files
cat-mode/README.md
2026-02-23 21:31:18 +00:00

36 lines
1.1 KiB
Markdown

# Cat Mode (Windows 10)
A tiny desktop app that toggles **Cat Mode**: blocks *physical* keyboard and trackpad/mouse input so your cat can sit on the laptop without wrecking your work. Injected input (from software like ShareMouse) is still allowed.
## How it Works
- Installs low-level Windows hooks for keyboard and mouse.
- When Cat Mode is ON, **physical** keyboard/mouse events are blocked.
- **Injected input** is allowed, so remote/KVM software can still control the machine.
## Run
```bash
python -m pip install -r requirements.txt
python main.py
```
## Tray Icon
- The app shows a tray icon (if dependencies are installed).
- Closing the window hides it to the tray.
- Use the tray menu to toggle Cat Mode, show the window, or quit.
## Emergency Unlock
- **Ctrl + Shift + F12** (physical keyboard) always disables Cat Mode.
## Notes
- If your KVM is a *hardware* USB device, its input may appear as physical and be blocked.
- If hooks fail to install, try running the script as Administrator.
## Future Ideas
- LAN trigger
- Auto-timeout
## Build Single EXE
```powershell
.\scripts\build_exe.ps1
```