Initial Commit - Cat mode for windows.

This commit is contained in:
serversdwn
2026-02-23 21:31:18 +00:00
commit 3e625a9669
5 changed files with 419 additions and 0 deletions

35
README.md Normal file
View File

@@ -0,0 +1,35 @@
# 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
```