Initial Commit - Cat mode for windows.
This commit is contained in:
35
README.md
Normal file
35
README.md
Normal 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
|
||||
```
|
||||
Reference in New Issue
Block a user