QKVMDocs
All pages

Using it

  • Tiles refresh about once a second. Click one to enlarge it (← / → switch, Esc closes). Pictures are drawn pixel for pixel: each frame is fetched with detail to spare (for a normal tile, the KVM's full frame) and scaled once to exactly the screen pixels it covers, which keeps text sharp at any display scaling.
  • Find and filter: the counts in the top bar (All / Online / No signal / Attention) are buttons, and the search box (/) narrows the wall by name, address or group.
  • Groups: give a KVM a group when adding or editing it (a rack, a room, a customer). Once there are groups, the top bar gets a list to show one of them at a time.
  • Display mode (the screen button, or D): the screens and nothing else, as large as fits, for a monitor on the wall. Move the mouse for a small bar that can rotate through the groups every 20 seconds; Esc leaves. The address gets #display, so a browser on a wall screen can be pointed straight at it. A viewer account signed in with Keep this browser signed in suits such a screen.
  • Find KVMs on my network (in Add KVM): asks every address on this computer's own network, and every Tailscale peer that is online, whether it is a KVM. It only looks, it does not log in. A KVM reachable both ways is listed once, with a choice of which address the wall uses for it.
  • One device, one tile. A KVM is known by the certificate it made for itself, and a server by its own number, so the wall notices when what you are adding is on it already under another address. It then asks: use the new address for the tile that is there, or keep both. Tiles that are the same device carry a small twice next to their name, which leads to the same choice. A device reached through somebody's front door (Cloudflare, a proxy) cannot be told apart this way, because the certificate it shows is the door's.
  • Open console (the arrow on a tile) opens that KVM's own page in a new tab for keyboard and mouse control.
  • Multi-port KVMs (GL.iNet Comet X, four computers on one KVM) get one tile with numbered port buttons. The lit one is the computer on screen; click another to switch. Such a KVM captures one computer at a time, so there is one live picture per KVM, not one per port. Switching takes the KVM a few seconds and also changes a monitor plugged into it.
  • Actions (the lightning button on a tile):
    • Keyboard – Wake screen, Ctrl+Alt+Del, Lock screen, Task Manager, Show desktop, Enter, Esc, Close window; Send keys… for any other combination; Type text… to type a command.
    • Your actions – key combinations and text you saved under Settings → Actions.
    • Power – Keep awake / Allow sleep (the KVM nudges the mouse); press power, hold power and press reset when the KVM has an ATX power board; Wake-on-LAN for the targets saved on it.
    • Reboot KVM – restarts the KVM itself.
  • Bulk actions: press Select (or S) to enter select mode, tick the KVMs you want (Select all takes the ones currently shown, so filter or search first), then Run action…. You confirm against the list of machines, anything destructive needs an extra tick, and each KVM reports back as it finishes, with a retry for the ones that failed.
  • Settings
    • KVMs – add, edit, remove; review a KVM's certificate.
    • Actions – your own actions. Saved text is stored encrypted and never shown again.
    • Network – where QKVM listens, the port, HTTPS. Changes apply without restarting the program.
    • Accounts – who may sign in, as what, and which KVMs they see (see Accounts).
    • Alerts – be told when a KVM goes offline or loses its picture (see Alerts).
    • Security – change your password, two-factor sign-in, the recovery key, sign out your other browsers.
    • Updates – the running version, checking for a newer one and installing it.
    • Activity – who signed in, who changed what, who sent which action (never what was typed).
    • About – version, website, source and licence.
  • Sign out and the theme switch (system / light / dark) are in the top bar.

Text is typed with a US keyboard layout. On a computer set to another layout, letters and digits arrive as written but some symbols do not.