deskwarden.io
Alt F1
You can finally use that Any key.

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

HotkeyWhat 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

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.

GestureWhat 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.