{"id":14965197,"url":"https://github.com/tolikpylypchuk/keyboardswitch","last_synced_at":"2025-05-12T17:23:51.479Z","repository":{"id":54248200,"uuid":"89720759","full_name":"TolikPylypchuk/KeyboardSwitch","owner":"TolikPylypchuk","description":"An application which switches typed text as if it were typed with another keyboard layout","archived":false,"fork":false,"pushed_at":"2024-10-09T05:39:59.000Z","size":6091,"stargazers_count":67,"open_issues_count":4,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-12T17:23:41.521Z","etag":null,"topics":["avaloniaui","charp","keyboard-layout","reactiveui"],"latest_commit_sha":null,"homepage":"https://keyboardswitch.tolik.io","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TolikPylypchuk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-28T15:44:02.000Z","updated_at":"2025-05-11T11:40:47.000Z","dependencies_parsed_at":"2024-01-02T00:29:57.063Z","dependency_job_id":"97a01a7b-dcc0-41fb-8c0e-7de8f6098e8e","html_url":"https://github.com/TolikPylypchuk/KeyboardSwitch","commit_stats":{"total_commits":638,"total_committers":2,"mean_commits":319.0,"dds":"0.0031347962382445305","last_synced_commit":"14dc9629daeeba7afe74d35cd2cae019352ed277"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolikPylypchuk%2FKeyboardSwitch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolikPylypchuk%2FKeyboardSwitch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolikPylypchuk%2FKeyboardSwitch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolikPylypchuk%2FKeyboardSwitch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TolikPylypchuk","download_url":"https://codeload.github.com/TolikPylypchuk/KeyboardSwitch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253785240,"owners_count":21963934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avaloniaui","charp","keyboard-layout","reactiveui"],"created_at":"2024-09-24T13:34:21.483Z","updated_at":"2025-05-12T17:23:51.447Z","avatar_url":"https://github.com/TolikPylypchuk.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Keyboard Switch\n\nKeyboard Switch is an application which switches typed text as if it were typed with another keyboard layout.\n\nInstead of manually retyping all that text that you have mistyped, you can switch it using this app. It will copy the\ntext, switch it, and paste it instantly. You just have to select the text and press the magic key combination.\nThat's it!\n\nKeyboard Switch consists of two apps:\n\n- Keyboard Switch Service - this app always runs in the background and does the switching when you press the magic key\ncombination\n\n- Keyboard Switch Settings - this app is used to configure the service app\n\n## Quick Start\n\nYou can get the latest release of the app [in the releases page](https://github.com/TolikPylypchuk/KeyboardSwitch/releases).\n\n### Windows\n\nDownload the _.msi_ file and run it to install the app. If your computer runs on the x64 architecture, then you should\nget the _x64_ installer. If your computer runs on the Arm architecture, then you should get the _arm64_ installer. If\nyou're not sure, then you most likely need the _x64_ installer.\n\nAfter installation, the Keyboard Switch Settings app will start. It may take some time as the app will do some initial\nsetup. If it doesn't start for some reason, then find it in the list of your apps.\n\nIn the opened app press _Start_.\n\nThat's it! You're ready to use Keyboard Switch in its basic configuration. There's a big chance you won't need to\nconfigure it further. But if you do, the you can read more [in the docs](https://docs.keyboardswitch.tolik.io).\n\nTo switch text forward, select the text, and press \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e twice. To switch it backward, press\n\u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e twice instead.\n\n### macOS\n\nDownload the _.pkg_ file to install the app. If your computer runs on an Intel CPU then you should get the _x86\\_64_\npackage. If your computer runs on an Apple CPU (e.g. M1) then you should get the _arm64_ package.\n\nAfter installing the app, open Keyboard Switch Settings - it should appear in the list of your apps.\n\nImmediately upon opening the app a dialog window should appear which says that Keyboard Switch would like to control\nthis computer using accessibility features. The app needs this to listen to the magic key combination while running in\nthe background, and without these permissions it won't work.\n\nClick the _Open System Preferences_ button on the dialog window. Unlock the settings and check the _Keyboard Switch_\ncheckbox. Lock the settings, close System Preferences, and go back to the Keyboard Switch Settings app.\n\nIn the settings app press _Start_.\n\nThat's it! You're ready to use Keyboard Switch in its basic configuration. There's a big chance you won't need to\nconfigure it further. But if you do, the you can read more [in the docs](https://docs.keyboardswitch.tolik.io).\n\nTo switch text forward, select the text, and press \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e twice. To switch it backward, press\n\u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e twice instead.\n\nTo uninstall Keyboard Switch you should run an uninstaller package. You can get it from the releases page as well.\n\n### Linux\n\nThe app is available as a deb package (for Debian-based distributions, such as Ubuntu, Mint etc.), an RPM package (for\nRHEL-based distributions, like Rocky Linux or Fedora, as well as SUSE), and a simple _tar.gz_ file.\n\nNote that Keyboard Switch only works on X11 - it won't work on Wayland (even with XWayland).\n\nIf you use the deb or RPM package, then simply install it either by double-clicking on it, or through the terminal. If\nyou use the _tar.gz_ file, then the set-up is not quite as quick, so you can read about it in\n[the installation page](https://docs.keyboardswitch.tolik.io/usage-guides/installation#linux).\n\nBear in mind that the RPM package may need\n[additional setup](https://docs.keyboardswitch.tolik.io/usage-guides/installation#linux).\n\nAfter installing the app, open Keyboard Switch Settings - it should appear in the list of your apps (if your desktop\nenvironment groups your apps, then it will most probably appear under the _Utilities_ or _Accessories_ group).\n\nIf your desktop environment is GNOME then you should restart it right after opening Keyboard Switch Settings. If you're\nnot sure which desktop environment you're using then it's most probably GNOME since it's the default one on Ubuntu,\nDebian, Rocky Linux, Fedora and others (but not Linux Mint). Press \u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eF2\u003c/kbd\u003e, then type \u003ckbd\u003er\u003c/kbd\u003e\nand press \u003ckbd\u003eEnter\u003c/kbd\u003e. This will restart GNOME.\n\nIn the opened settings app press _Start_.\n\nThat's it! You're ready to use Keyboard Switch in its basic configuration. There's a big chance you won't need to\nconfigure it further. But if you do, the you can read more [in the docs](https://docs.keyboardswitch.tolik.io).\n\nTo switch text forward, select the text, and press \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e twice. To switch it backward, press\n\u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e twice instead.\n\n## How the App Works\n\nThe app is composed of two parts: the Keyboard Switch service and the Keyboard Switch Settings app. The service always\nruns in the background (and starts when you log into the system) and listens to key presses. When you press the magic\nkey combination, it reacts by copying the selected text, transforming it, and pasting it for you. The settings app is\nused for configuring the service and for starting/stopping it manually.\n\nHere are the basic steps you should take to switch the text:\n\n- Type some text using an incorrect layout\n- Realize your mistake\n- Select the text (you can press \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eA\u003c/kbd\u003e to select all text, or \u003ckbd\u003eCommand\u003c/kbd\u003e+\u003ckbd\u003eA\u003c/kbd\u003e on\nmacOS)\n- Press the magic key combination (the default is pressing \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e twice)\n- Profit\n\nThe app uses the list of your layouts in the same order as defined by the system. You can switch both forward and\nbackward through this list. It will look at the current layout to determine how to switch text, so you shouldn't change\nthe layout before switching. The app also automatically changes the layout, so you don't have to do it yourself.\n\nThe app uses the clipboard to get the text to transform, and then puts the transformed text back into the clipboard.\nThe app will try to preserve the text that was in the clipboard before switching, and to restore it afterwards. It\ndoesn't guarantee that the text will be restored though. Also, any non-text data (e.g. a file or a picture) will not\nbe restored.\n\n## Supported Platforms\n\nKeyboard Switch works on Windows 10/11 (version 1607 or later), macOS 10.15 or later, and Linux via X11. Wayland support\nmay come in a future version, but there are\n[several prerequisites](https://github.com/TolikPylypchuk/KeyboardSwitch/issues/54).\n\nThe x64 and Arm64 architectures are both supported.\n\n## More Info\n\nIf you want to know more about the Keyboard Switch app and how to use it, check out the docs:\n[https://docs.keyboardswitch.tolik.io](https://docs.keyboardswitch.tolik.io).\n\n## Changelog\n\nSee the [changlog file](https://github.com/TolikPylypchuk/KeyboardSwitch/blob/master/CHANGELOG.md) for the detailed list\nof changes across versions.\n\n## Icon\n\nIcon made by [Smashicons](https://smashicons.com) from [www.flaticon.com](https://www.flaticon.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftolikpylypchuk%2Fkeyboardswitch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftolikpylypchuk%2Fkeyboardswitch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftolikpylypchuk%2Fkeyboardswitch/lists"}