cat-mode/README.md

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

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

.\scripts\build_exe.ps1