connecting...

input overlay

connection

address

port

auth token

obs browser source url

instructions

Single PC Setup

get the input-overlay-ws server
run it and right click the tray icon to open the settings
copy your auth token

(you can change it to whatever you like)

paste the token in the auth token field above
configure your overlay to your liking, then click the ⎘ copy url button and paste the copied url as an OBS browser source

tip: you can configure the key whitelist in the server settings to ensure you are only sending keys over your network that are configured in the overlay

Sending keys to another pc

(eg. from gaming to streaming pc)

open the input-overlay-ws server settings and enable the http server
(run the ws server on your gaming pc)
change the address in to the address of your gaming pc
run ipconfig in cmd and copy the local IPv4 address (usually 192.168.0.1 or 192.168.X.X with X being 0-255)
click the open in browser button inside the http server settings
enter the gaming pc's address in both the input-overlay-ws and the hosted configurator
click the ⎘ copy url button to copy your hosted overlay url from the hosted configurator and add it as a browser source in your OBS running on the streaming pc

cheat sheet

key syntax

Comma-separated entries per row. Basic format:

[internal_name]:"[label]":[width class]

multi-key bindings

key_w|mouse_4:"W" - both W and mouse4 light up the same key
key_q|key_e:"use" - Q or E both trigger "use"

standard keys

label	internal name
a-z	`key_a` - `key_z`
0-9	`key_0` - `key_9`
` - = [ ] \ ; ' , . /	`key_backtick`, `key_minus`, `key_equals`…

special keys

label	internal name
esc, tab, caps	`key_escape`, `key_tab`, `key_capslock`
shift / ctrl / alt (L/R)	`key_leftshift`, `key_rightshift`, etc.
space, enter, backspace	`key_space`, `key_enter`, `key_backspace`
arrows	`key_leftarrow`, `key_uparrow`, `key_rightarrow`, `key_downarrow`
f1-f12	`key_f1` - `key_f12`
ins, del, home, end, pgup, pgdn	`key_insert`, `key_delete`, `key_home`, `key_end`, `key_pageup`, `key_pagedown`
numpad 0-9	`key_numpad_0` - `key_numpad_9`

mouse identifiers

label	internal name
m1 (left)	`mouse_left`
m2 (right)	`mouse_right`
m3 (middle)	`mouse_middle`
m4, m5	`mouse_4`, `mouse_5`
scroller	`scroller:"default":"up":"down"`
side buttons	`mouse_side:"m5":"m4"`
mouse pad	`mouse_pad:width:height:anchor` `mouse_pad:u4-25:u3-31:a-tl` anchor classes: top-left: `a-tl`, top-right: `a-tr`, bottom-left: `a-bl`, bottom-right: `a-br`

width classes

u0-01 through u7 in 0.01u increments

special syntax

syntax	effect
`invisible` / `key_escape:"invis":u2`	invisible spacer (supports width classes)
`dummy`	empty row placeholder
`key_a\|key_b:"A"`	multi-key binding via pipe

patch notes

2026-04-21

ws server

updated to the latest analogsensepy lib (1.0.5) which should offer better linux compatibility

overlay

added a workaround for key row size mismatch

2026-04-20

ws server

switched previous analog implementation with the analogsensepy lib
fixed final released analog_depth of 0.0f not being transmitted, analog visualization should now not get stuck at low depth when releasing the key
removed problematic build flag (--uac-admin)

overlay

lowered analog_depth noise threshold

2026-04-17

ws server

slight logger changes
fixed build workflow on bimbows not adding previledges to the manifest
cleaned up old port dialogs that could cause a rebind loop (oopsie i forgor about them)
added toggle to settings that allows you to list all usage pages for supported analog devices

TODO

for analog support send the last analog_depth=0.0 event regardless of hz to prevent it being stuck at the last known depth

overlay

added zoom modifier for custom mouse_pad textures
retired an old workaround for stuck keys when using the (now unsupported but technically still somewhat compatible) input-overlay obs plugin as ws provider

2026-04-11

ws server

improve wooting analog interface v2 support
cache the users keyboard layout on boot and translate it
tell w11 dwm to stfu and use hard window edges when built from gh :glueless:
wooting analog interface add first byte to detect fn

overlay

update full qwerty preset

2026-04-10

ws server

update analogsense py to support wooting analog interface v2 (new beta firmware)

overlay

update analogsense js sdk to support wooting analog interface v2 (new beta firmware)

2026-04-09

ws server

the ws server will request admin on windows by default
error handling for invalid addresses
added optional overlay frontend self hosting (this wont always run the latest overlay version that is being hosted on overlay.girlglock.com)
fix http server not restarting when address is changed
fix http server not doing proper cleanup when shutting down
autostart will now use an elevated scheduled task on windows
http server will now serve as a dual pc solution
update popup markdown now properly supports codeblocks
fix windows build not having proper window styling (maybe ?)
fix invalid address oversight

overlay

slightly clearer ws related logging inside overlay mode
retire bundled html file for dual pc

2026-04-05

ws server

added experimental linux support
changed default port to 4455
better error handling when port is taken
added auto update downloader (only windows for now)

overlay

changed default port to 4455

2026-04-03

ws server

some rawinputbuffer related error handling
added better sanitized debug logging
some ws improvements

overlay

upped max fps of the mouse_pad element to 120 from 60
copy url button now turns automatically into download html if address is non localhost
added explicit copy to share button
fix mouse_pad trail fadeout
increase max dpi from 3200 to 32000 for mouse distance tracking

2026-04-02

overlay

added pan mode to mouse_pad
improved trail rendering for mouse_pad using catmull spline
fixed a bug that prevented mouse_pad elements from recieving data when the only element added was mouse_pad
fixed up the default gamepad preset a bit
added distance tracking for mouse_pad
added custom background texture for mouse_pad
added trail length override

2026-04-01

overlay

added wip gamepad support and example preset (still buggy)

2026-03-30

overlay

add bundled overlay html file download for pc to pc ws

2026-03-29

ws server

added raw input buffer read for mouse inputs
improved ws message queue
capped polling rate for analog devices to 125Hz
update popup improvements

overlay

new mouse_pad element that listens to raw input buffer ws events (see cheat sheet)
slightly improved overlay autosizing

2026-03-20

quality of life

remade the configurator ui

2026-03-21

ws server

added autostart toggle
added update check popup
added cpu affinity
added baloon notification toggle

2026-03-20

quality of life

remade the configurator ui

2026-03-18

quality of life

added analogsense js sdk for live key preview
added analog mode-specific settings (key legend fill modes)
added force-disable analog option

bug fixes

removed transition times from analog_depth css events causing visible lag
interpolated analog_depth to compensate for removed transitions

2026-03-15

new server

added more complex ws server with settings window and analog keyboard support

2025-12-27

quality of life

added presets dropdown
added img tag support in key labels
added + button for adding keys to rows

2025-12-06

bug fixes

fix mouse_4 and mouse_5 elements
fix stuck key logic on unfocused browser sources

2025-12-04

new config vars

key gap modifier
bold font checkbox

2025-12-02

quality of life

url cfg compression (50% smaller)
"edit this layout" button in overlay mode

2025-11-30

quality of life

patch notes viewer
separate scroll up/down
fully customizable mouse row
cheat sheet

live preview

colors & options

glow color

active key bg

inactive key bg

outline color

active font color

inactive font color

font family

bold font hide mouse buttons hide scroll combo

analog live preview device

‎

analog legend fill mode

force disable analog

animation & sizing

glow radius 24px

border radius 8px

press scale 1.05x

anim speed 1.0x

outline (unpressed) 2px

outline (pressed) 2px

key gap 100%

mouse pad

mode

highlight m1 in trail show dist tracker

trail length 150pts

fade duration 600ms

sensitivity 1.0x

mouse DPI (dist tracker) 400 DPI

background texture url

custom texture zoom

custom layout

preset

top row

qwerty row

asdf row

zxcv row

space row

mouse row

add key