Configuration & Simulator (Beta)
Configuration & Simulator is for trying a change before saving it: edit bindings in the browser, preview pointer actions, and adjust Grid, Recursive Grid, and UI Hint styles. Data stays in your browser and is never uploaded. For complex actions, external commands, and advanced fields, treat the TOML documentation as authoritative.
With KeySteer 0.8.11 or later, choose Configuration & Simulator... from the Windows tray or macOS top status menu to open the active configuration directly. The configuration is passed to the browser in a URL fragment, which GitHub Pages requests never receive; the page clears it immediately after reading it. A browser extension could theoretically read the page address during the handoff, so do not keep passwords or tokens in configuration commands.
Open Configuration & Simulator ↗
Recommended workflow
When workspace.ksw exists, opening the simulator from the app menu imports the active bindings and saved Layout/Tabs presets together. Select a layout number to edit its regions. Ctrl+S updates its note; Save and download workspace includes current edits and preserves the other presets. Replace the application's workspace.ksw with the downloaded file. Each Alt+W → R reads it again, without restarting, reloading TOML, or watching files. A separate workspace-file import button is also available.
- Open the simulator, import an existing TOML file, or start with the default configuration.
- Change bindings and mode styles while watching the preview.
- Download the generated
keysteer.<name>.toml. - Place it in KeySteer's data directory and choose Reload Configuration from the status menu.
- When configuration errors occur, run
keysteer --check -c <file>; the Rust program's validation is authoritative.
The simulator is helpful for rapid experimentation and previewing, but it is not a complete configuration validator. Complex fields, platform permissions, external commands, and final validation remain the responsibility of KeySteer. See Configuration and Modes and actions for the full syntax.
The simulator opens in a new page to keep its wide keyboard layout from covering the documentation sidebar. It also works well on a second display.
Visual window card editing
Select Window or an A/E/R/T child mode in the simulator to open the live card editor. Color pickers and opacity sliders control the background, number, app name, title and border. Edit fonts, sizes, weight, corner radius, border width and spacing alongside the preview. Click or drag an anchor, draw a range, adjust the four inset sliders, or choose a positioning preset. Changes update the simulator and exported TOML, with individual reset controls. Positions remain preferences; collision avoidance still applies.