connecting...

input overlay

connection

address

port

auth token

obs browser source url

instructions

Option #1 (recommended)

get the input-overlay-ws server
run it and right click the tray icon to copy your auth token
paste the token in the auth token field below
configure your overlay, then copy the URL and paste it as an OBS browser source

tip: edit config.json to change the address/port
tip: configure the key whitelist in the server settings

🛈 Supports hall effect keyboards via the server settings.

Option #2

install the input-overlay OBS plugin
enable the websocket server in plugin settings
restart OBS, copy the overlay URL, add it as a browser source

🛈 Easier setup but no authentication support.

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"`

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

glow color

active key bg

inactive key bg

outline color

active font color

inactive font color

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%

font & options

font family

bold font hide mouse buttons hide scroll combo

analog

live preview device

‎

legend fill mode

force disable analog

preset

top row

qwerty row

asdf row

zxcv row

space row

mouse row

add key