Couchwarden Guide
Everything lives in the tray icon. This page explains what each guard does, and the hotkeys and gestures that drive them.
First run
Couchwarden starts as a single icon in the system tray. No window, no console. Right-click the icon to open the menu: every feature can be toggled there, and every change is saved immediately and remembered across restarts. The menu always shows the current hotkey next to each item, so if you ever forget a binding, the tray is the answer.
The icon itself tells you the current state at a glance: a green check when all is normal, lock marks while a lockdown is active, and a sleeping "Zz" while the keyboard guard is armed after idle.
Hotkeys at a glance
| Hotkey | What it does |
|---|---|
| Ctrl+Alt+G | Cycle the keyboard guard mode: sliding → fixed → disabled. |
| Alt+F1 | Mouse lockdown on/off. Freezes movement, clicks, and wheel. |
| Alt+F2 | Keyboard lockdown on/off. Swallows every keystroke. |
| Alt+F3 | Cursor auto-hide on/off. |
| Alt+F5 | Put the monitor to sleep right now. Any key or mouse input wakes it. |
| Ctrl+Alt+U | Release every lock at once. Always works, whatever is locked. |
| Ctrl+Alt+Q | Quit Couchwarden. Press it twice within three seconds. |
| Alt+F6 | Pro Reading mode on/off: mouse locked, wheel still scrolls. |
| Ctrl+Alt+P | Pro Cycle through your saved profiles. |
| Ctrl+Alt+Z | Pro Restore the last moved or resized window to where it started. |
Every toggle confirms with a short beep: higher pitches mean on, lower pitches mean off. All hotkeys can be rebound (see Settings). The tray menu shows the current hotkey next to each item, so if you change one, the menu is the place to check.
The keyboard guard
The problem Couchwarden was built for: a wireless keyboard goes to sleep, its backlight turns off, and the first key you press wakes it up and lands in whatever window has focus. Or a cat, a toddler, or your elbow types for you while you're not looking. The keyboard guard watches how long the keyboard has been idle; once it's been quiet past the idle delay, the next keystroke is treated as suspect and suppressed.
Set the idle delay from the tray (Idle delay submenu, in minutes). A good value is the same as your keyboard's own backlight or sleep timeout; that way the suppressed key is exactly the invisible wake-up key.
The three modes
- Sliding. Every suppressed key extends the grace window. Best against sustained mashing (a cat settling onto the keys): nothing gets through until the keyboard has been genuinely quiet.
- Fixed. Only the trigger key (and its own modifiers) is eaten; a short fixed grace follows, then everything passes. Best when you type fast and only want the single invisible wake-up key gone.
- Disabled. The guard stands down entirely. Use for gaming, where the first keypress matters.
Cycle modes with Ctrl+Alt+G, or pick one and its grace duration from the tray. Each mode has its own distinct beep so you know where you landed without looking.
Lockdowns
Mouse lockdown (Alt+F1) freezes the pointer completely: movement, clicks, and wheel. Clean the mouse, hand the room to the kids. Keyboard lockdown (Alt+F2) does the same for keys.
While a lockdown is active, a small LOCKED pill sits in the corner of the screen, red for keyboard and amber for mouse, so a locked input is never a mystery, even if the tray icon is hidden. Each pill shows how long its lock has been on, and if you point the cursor at the pills they fade to a ghost so they never cover what you're looking at. Pick which corner they live in from the tray (Options → Lock pills corner). The pill is click-through and never steals focus. The release hotkey (Ctrl+Alt+U) always works; that's the whole point of it being a hotkey.
Block clicks while typing
A mouse click that lands in the middle of real typing is usually a knee, a wrist, or something sliding off the couch, not intent. With this guard on (tray toggle, off by default), button presses that arrive within a short window after a keystroke are swallowed; pointer movement and scrolling always pass. The release window is adjustable from the tray (Options → Click release delay).
The screen: held awake, or put to sleep
Keep screen awake (tray submenu) holds off display sleep three ways: Off; While fullscreen, armed only while a movie, game, or presentation actually owns the screen; or Always. When the hold is real, the tray icon carries a small dot so it's never invisible: green for the fullscreen hold, white for Always.
The opposite direction is one key: Alt+F5 puts the monitor to sleep immediately. Done for the night, screen off, no menu-diving. Any key or mouse movement wakes it, exactly like Windows' own display sleep.
Cursor auto-hide
The pointer disappears after a couple of seconds of mouse stillness and immediately when you start typing; it returns the instant the mouse moves or a button is pressed. Pick the delay in the tray (Cursor idle delay), toggle with Alt+F3.
Window control Pro
Part of Pro. Everything in this section unlocks with a Pro key in the same app. The free build's tray menu and hotkeys do not include these gestures.
Hold Alt and act on any point of a window. No hunting for title bars or edges. You can let go of Alt once the drag has started.
| Gesture | What it does |
|---|---|
| Alt + left-drag | Move the window from anywhere inside it. |
| Alt + right-drag | Resize. The quadrant you start in picks which corner or edges move. |
| Alt + middle-drag | Hand tool: scroll the window under the cursor, browser-style, without focusing it. |
| Alt + wheel | Fade the window under the cursor toward transparent or back. It can never vanish entirely. |
| Ctrl+Alt + middle-click | Reset that window to fully opaque. |
| Double-tap Alt, left-click | Minimize the window under the cursor. |
| Double-tap Alt, right-click | Restore: brings back the last minimized window, or un-maximizes. |
| Double-tap Alt, middle-click | Close the window under the cursor, politely, so save prompts still appear. |
| Esc during a drag | Cancel: the window snaps back to where the gesture started. |
| Ctrl+Alt+Z | Restore the last-manipulated window to its position and size from before you started rearranging it. |
Maximized windows are left alone, and all gestures stand down while mouse lockdown is on. The whole suite toggles from the tray (Window drag/resize), and the modifier can be changed from Alt to Ctrl, Shift, or Win in settings.
Hand-tool tip for terminal apps: full-screen terminal programs that capture the mouse ignore scroll input that arrives with a modifier key held. The gesture only needs Alt at the moment you press the middle button, so grab, let go of Alt, and keep dragging. Everything else scrolls fine with Alt held the whole time.
Reading mode Pro
A mouse lockdown that still lets the wheel scroll. Park the cursor over a long page and press Alt+F6, or pick Reading mode in the tray. The cursor hides, movement and clicks are frozen, and the wheel keeps working. Lean on the mouse, rest it on the couch arm, let the cat sit on it; nothing gets clicked. Press the hotkey again, or Ctrl+Alt+U, to come back.
One-hand mode Pro
Tap modifier keys one at a time instead of holding them together: Ctrl, then Alt, then the key. Turn it on from the tray (One-hand mode). It works in every program, because Couchwarden switches on Windows' own Sticky Keys while the mode is on and hands your previous Sticky Keys settings back when you turn it off or quit.
Each tap raises a small pill in the centre of the screen showing what is held. A tap that goes nowhere expires on its own after a couple of seconds. Tap a modifier twice to hold it until you tap it a third time. If the little blip on every modifier tap gets annoying, turn it off in Options → Sound on modifier taps; every other sound stays.
Profiles Pro
Save the whole setup under a name and switch between setups in one pick. Set things the way you want them, then choose Save current setup as profile in the tray and give it a name. The Profile menu at the top of the tray switches between them, and Ctrl+Alt+P cycles through them, starting from Standard, your everyday setup.
A profile holds which guard modes are on, both grace values, cursor hiding, keep-awake, the window gestures, the lockdowns and the type-click guard. While a profile is active the tray also offers Update, Rename and Delete for it, and View profile settings shows what each one holds. Locks are never switched on by themselves when Couchwarden starts.
Unlocking Pro
Pro is a one-time purchase on the Pro page; the tray item Get Couchwarden Pro… opens it too. Your key arrives by email. Right-click the tray icon, choose Enter licence key…, and either paste the key or use Load key file… on the attached file. Pro turns on at once, with no restart and no network connection: the key is checked on your PC. About Couchwarden then shows who the licence belongs to. Keep the email; the same key works after a reinstall or on a new PC.
Settings
Day-to-day options (modes, delays, feature toggles) live in the tray menu and
persist on their own. To change a hotkey, use Options → Edit hotkeys… in
the tray. Deeper preferences, including every hotkey binding, also live in
config.json in the app's folder. Hotkeys use the format
Mod+Mod+Key (modifiers: Ctrl, Alt, Shift, Win), and the file documents
every option inline. Restart Couchwarden after editing hotkeys; everything else
applies live.
Stuck or surprised by something? The support page covers the common cases, or email paul@deskwarden.io.