Settings — v0.6.72
English | Українська
Launch as administrator
With Start with Windows and Start with Windows as administrator enabled, exit the development build and open the regular KSwitcher executable. If it starts with standard rights, Windows asks for administrator approval for the same account. This also applies to other fresh launches of the regular executable without command-line arguments.
Mouse buttons and application profiles
Open Settings → Mouse. Global supplies fallback actions. Use + to add a profile and select its applications. Drag the crosshair onto a window, browse for an executable or a Windows shortcut, or enter an executable name. The Applications column shows the selected scope, and each row has an Active checkbox. Double-click a profile to edit it.
Starting with v0.6.67, buttons and wheel events forwarded by KSwitcher Computers or Mouse Without Borders use the profiles on the receiving PC. Configure and save the action on that PC. If Add mouse event… cannot detect a forwarded wheel direction, capture it with a mouse connected directly to the receiving PC. The capture dialog still checks Windows Raw Input.
Double-click a mouse event to choose its action. Click Apply, then Save in Settings. A profile for the active application overrides the fallback for events it defines. When active profiles overlap on an event and application, KSwitcher reports a conflict. Mouse profiles and custom events are included in OpenBao synchronization.
For example, use the side buttons for volume in Global and for Back and Forward in a profile for Chrome. Set Step (%) for volume actions. The indicator appears on the monitor under the pointer and hides one second after release. Holding a button repeats the action when Windows delivers separate press and release events. Use Test mouse buttons here to inspect those events. If no press appears until release, check the button assignment in any mouse utility that can remap it.
To add an event, click + next to Mouse events or right-click the list and choose Add mouse event…. Move the pointer into the capture area and scroll the wheel. Vertical and horizontal directions can be named and saved when Windows reports them through both input paths. Pressing an existing button, or repeating an already added direction, highlights the matching row. Extra device controls that provide no supported Windows mouse signal cannot be assigned here.
For example, capture Wheel down, name it Lower volume, then double-click the new row, choose Volume down, and click Apply → Save. Scrolling down runs that action wherever the selected profile applies. Use Reset to default in the row menu to restore normal scrolling for the profile.
LAN connection and saving — v0.6.63
LAN now tries direct TCP, reverse TCP and encrypted UDP automatically. Connection help supplies copyable firewall commands after unsuccessful attempts. Pairing shows progress; LAN changes save immediately and do not require the main Settings Save button. Update both PCs via the tray Update command.
Pick an application by its window — v0.6.62
- Open Settings → Languages → Languages for applications....
- Hold ⊕ Drag to window and drag the crosshair over a visible part of the target window. The outline previews which window will be selected.
- Release to select the application. KSwitcher adds it to the list if needed. Press Esc to cancel the drag.
- Select the layouts you want, choose Use languages, then Save. Pending edits for other applications are preserved.
If the window is fully covered, move the dialog aside. Add a closed application by its executable name. Picking a browser window selects the browser executable and covers all its tabs.
Languages for applications — v0.6.61
In Settings → Languages → Languages for applications..., select an application on the left and click its allowed layouts on the right. For example, leave Ukrainian and English selected for Codex. Every application has an independent selection. The list includes open applications and saved profiles. Add a closed application by executable name, such as Codex.exe. The rule covers every window of that application, including all browser tabs.
Switching applications preserves drafts. Choose Use languages, then Save. Use defaults resets only the selected application and Cancel discards edits in the dialog. A chat profile takes priority over an application profile, followed by the default cycle. The subset applies to Alt+Shift, Win+Space, Win+Shift+Space and Next layout. If an excluded layout is active, KSwitcher returns to an allowed one on its 250 ms check when idle. Missing layouts are skipped. The default cycle applies if none are installed. Windows languages remain installed.
Application profiles are included in OpenBao synchronization and manual export/import. Chat profiles continue to synchronize separately.
Download feedback and live Settings refresh — v0.6.59
Download remote shows Downloading remote settings from OpenBao..., then reports the server version and whether changes were applied or this PC was already up to date. Applied changes have a local backup. A failed download reports Download failed. Local settings were not changed. followed by the cause. HTTP 400 now distinguishes authentication, download and write requests: check login fields for authentication errors, or the KV v2 mount and profile path for download errors. Configuration/validation errors remain visible until another action.
After a successful explicit download, the existing Settings window refreshes automatically, keeping its selected tab. This also works if you close the Sync dialog before the download finishes. The confirmation warns that unsaved Settings edits will be discarded. Download does not write the remote profile; Keep this PC's layouts still preserves the local global cycle and its shortcuts. A failed download leaves the Settings draft intact. Automatic/background sync still uses the existing save/merge rules; this automatic editor refresh is for Download remote.
Saving while background settings change — v0.6.57
Press Save normally. Independent changes from the editor and resident process (for example settings sync) merge automatically. If the same setting changed on both sides, the dialog names the conflict and asks whether to keep your edits. Yes keeps your edits for conflicts while preserving unrelated resident changes; No leaves the window and all edits open. Export/reopen/import is not required. Validation errors also preserve the draft.
Open Settings from the tray. Switching tabs preserves your draft. The main Save applies settings. In Snippets, use Save snippets to apply snippet edits independently. Closing or cancelling with changes offers Save / Discard / Continue editing. Import and Export remain below every tab. Tab and Shift+Tab navigate visible controls; use arrow keys when the tab strip has focus. Access letters apply to the current tab.
| Tab | Controls |
|---|---|
| General | Recent-text conversion, switch layout after conversion, automatic correction and Correction options..., Windows startup/elevation, keep awake |
| Languages | Default cycle and order, direct layout shortcuts, refresh installed layouts, Languages for a chat..., Languages for applications... |
| Shortcuts | Six global shortcuts and Open editor after screen capture |
| Clipboard | History recording, limits, exclusions and OCR options… |
| Snippets | Trigger list, replacement text, application restrictions and Save snippets |
| Sync | OpenBao backup and synchronization via Sync settings… |
| Computers | Pairing and input sharing via Manage computers… |
| Diagnostics | Write log and View log… |
| Mouse | Global and application profiles, click and wheel actions, event capture and input diagnostics |
The smaller window uses the destination monitor's DPI and scrolls when the available desktop is too small. There is no settings migration to perform; existing values and shortcuts are preserved. The Snippets tab and Sync dialog each provide their own save action.
Unsaved changes and Save — v0.6.54
The status above the bottom buttons shows No unsaved settings and Save is disabled when the draft matches saved settings. After editing it shows Unsaved settings — click Save to apply and enables Save. Restoring the original values returns to the clean state; invalid input remains an unsaved edit until corrected or discarded.
In Languages for a chat..., Use languages or Remove profile updates the Settings draft. OK in automatic-correction and OCR preferences also updates the draft. Returning to Settings refreshes the status immediately; press the main Save to apply and save these changes. Cancel or the close button in those child dialogs discards their unaccepted edits.
Save snippets and the Sync connection dialog save their own changes immediately. Saving a snippet updates Settings without falsely indicating a pending snippet change; any other unsaved Settings edits remain pending. Switching tabs does not save. Import updates the draft; Export writes a separate file without applying the draft. Closing Settings with edits still asks whether to save, discard or keep editing.
Screenshots
The screenshots use demonstration settings from v0.6.72. Your saved values and installed languages may differ. The Mouse tab is shown above.
Chat language profiles · Keyboard guide · Home
Viber profiles disabled — v0.6.51
Viber header OCR introduced in v0.6.49 is disabled because repeated recognition caused delays. No Viber OCR runs in the background, during switching/conversion or when opening profiles. Existing profiles remain stored and appear as Viber (inactive); they do not restrict languages. Viber uses ordinary Windows layout switching and the global Next layout cycle. Telegram and Teams profiles are unchanged. Clipboard/image OCR and Tesseract options remain available. No settings reset is needed. Saved Viber profiles still require v0.6.49 or newer to load; keep a backup before downgrading.
Chat languages in synchronization — v0.6.53
Chat language profiles are included in settings synchronization. Update all PCs to v0.6.53 or newer, save the profile, then use Settings → Sync → Sync settings… → Save / Sign in / Sync. Merging, conflicts and missing layouts.
KSwitcher LAN — v0.6.59
LAN: multiple PCs on a grid, mouse/keyboard edge routing, and new text/image clipboard copies shared with online pairs. Update all PCs; discovery is off by default.