https://github.com/eddie-dunn/swytcher
Automatic keyboard layout switcher
https://github.com/eddie-dunn/swytcher
keyboard layout linux switcher
Last synced: over 1 year ago
JSON representation
Automatic keyboard layout switcher
- Host: GitHub
- URL: https://github.com/eddie-dunn/swytcher
- Owner: eddie-dunn
- License: mit
- Created: 2017-08-31T19:02:03.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-12-02T15:21:08.000Z (over 1 year ago)
- Last Synced: 2024-12-02T16:38:03.979Z (over 1 year ago)
- Topics: keyboard, layout, linux, switcher
- Language: Python
- Size: 88.9 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.rst
- Changelog: HISTORY.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE
- Authors: AUTHORS.rst
Awesome Lists containing this project
README
===============================
Swytcher
===============================
.. image:: https://img.shields.io/pypi/v/swytcher.svg
:target: https://pypi.python.org/pypi/swytcher
.. image:: https://img.shields.io/travis/eddie-dunn/swytcher.svg
:target: https://travis-ci.org/eddie-dunn/swytcher
.. image:: https://readthedocs.org/projects/swytcher/badge/?version=latest
:target: https://swytcher.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://pyup.io/repos/github/eddie-dunn/swytcher/shield.svg
:target: https://pyup.io/repos/github/eddie-dunn/swytcher/
:alt: Updates
*Automatically switches your keyboard layout based on your active window.*
Are you using multiple keyboard layouts? Have you discovered that the US
keyboard layout is a lot more suitable for programming than the layout you have
to use when writing email or otherwise communicating in your native language?
Does it annoy you that you need to remember to manually switch between layouts
when going from VIM to your chat/email/whatever app?
If so, Swytcher will solve your problems.
* Free software: MIT license
* Documentation: https://swytcher.readthedocs.io.
Features
--------
* Switch keyboard layout based on X window class
* Switch keyboard layout based on X window name
Planned features
* Switch layout based on combination of window class and name
* Remember last keyboard layout for each window
Installation
------------
.. code-block:: bash
$ pip install --user swytcher
Usage
-----
First, copy the sample configuration:
.. code-block:: bash
$ swytcher --cpcfg
Now you can edit `~/.config/swytcher/config.ini` and add the window
classes/names to the corresponding layout section.
`layout_primary` maps to your first keyboard layout, and `layout_secondary`
will map to your second. If you have more than two layouts you will have to add
more sections to the config file. Each additional layout section must start
with `layout`, and be uniquely named. The order that they have in the config
file should map to the order that you have defined your different layouts in.
Once you are done editing your config file, you can start Swytcher, and your
keyboard layout will be switched whenever you change focus to a window that
corresponds to a window class and/or name in your config file.
Swytcher has been tested with the Gnome Desktop Environmant and the i3 window
manager. Since Swytcher looks at your X keyboard config it should work with
most DEs and WMs.
Credits
-------
This package was created with Cookiecutter_ and the
`audreyr/cookiecutter-pypackage`_ project template.
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage