Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hire-hoffee/keyboard-lang-switcher
This Python script allows you to quickly convert the keyboard layout of selected text by double-pressing the certain key.
https://github.com/hire-hoffee/keyboard-lang-switcher
caramba-switcher gnome keyboard language linux puntoswitcher shortcut switcher ubuntu
Last synced: about 1 month ago
JSON representation
This Python script allows you to quickly convert the keyboard layout of selected text by double-pressing the certain key.
- Host: GitHub
- URL: https://github.com/hire-hoffee/keyboard-lang-switcher
- Owner: Hire-Hoffee
- Created: 2024-09-14T17:06:06.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-09-18T16:18:52.000Z (2 months ago)
- Last Synced: 2024-10-13T02:22:21.581Z (about 1 month ago)
- Topics: caramba-switcher, gnome, keyboard, language, linux, puntoswitcher, shortcut, switcher, ubuntu
- Language: Python
- Homepage:
- Size: 8.5 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Keyboard Layout Text Converter for Linux
This Python script allows you to quickly convert the keyboard layout of selected text by double-pressing the Shift key. For example, if you have text typed in Russian and you need to quickly convert it to English, you can select the text and double-press Shift.
(You need to use GNOME environment for this script to work)
## Features
- Converts text between two specified keyboard layouts.
- Uses a customizable dictionary for accurate character mapping.
- Supports customizable double press interval and hotkey.
- Clears the clipboard after pasting the converted text.
## Installation
1. Clone the repository or download the source code.
2. (Optional: Create and activate virtual environment with `python3 -m venv venv` and `source venv/bin/activate` commands)
3. Install the required libraries using pip `pip install -r requirements.txt`.
4. Optional: update the `src/settings/settings.py` file with your desired settings.
5. Optional: update a file `src/settings/dictionary.py` with your language. This file should contain a dictionary mapping characters between the two keyboard layouts.
## Usage
1. Run the `python3 src/index.py` command (you can run the script on the background by `nohup python3 src/index.py &`).
2. Select the text you want to convert (if not selected, the last typed word will be converted).
3. Double-press the `Shift` key (or your configured hotkey).
4. The converted text will be pasted in place of the selected text.
## How it Works
The script uses the `pynput` library to listen for keyboard events. When a double press of the specified key is detected, it copies the selected text to the clipboard, converts it using the character mapping dictionary, and pastes the converted text back. The `pyperclip` library is used for clipboard operations.
## Additionally
- If you use virtual environment and script do not run, you can try this command `./venv/bin/python src/index.py`.
- Maybe you need to install additional apt packages (check your terminal).
- You can create standalone executable with `pyinstaller -F -n=KeyboardLangSwitcher src/index.py` command. File will be located on dist directory.
- You can add script or standalone binary as a startup application
1. Open Startup Applications app
2. Add name, command to start and description of the application
3. Restart the system
