x11-wm/stumpwm.stumpwm-contrib
1
0
Fork 0
mirror of https://github.com/stumpwm/stumpwm-contrib.git synced 2026-09-10 07:26:25 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
stumpwm.stumpwm-contrib/util/kbd-layouts
History
mgr 000ffe3916 update readme to explain behavior more accurately
2020-05-07 12:55:52 +02:00
..
kbd-layouts.asd Added meaningful descriptions to all non-documented modules 2018-03-15 22:34:26 -04:00
kbd-layouts.lisp set the defaults in variables not in top-level calls. 2020-05-07 12:54:31 +02:00
package.lisp Allow reloading xmodmap on each layout change 2017-10-23 13:08:40 +02:00
README.org update readme to explain behavior more accurately 2020-05-07 12:55:52 +02:00

README.org

Keyboard layout switcher for StumpWM

Usage

Add 

(load-module "kbd-layouts")

to .stumpwmrc

You can specify your keyboard layouts using the function KEYBOARD-LAYOUT-LIST. Layouts are represented by strings identical to those used by setxkbmap, e.g.:

(keyboard-layout-list "us" "pl" "ru -variant phonetic")

This will also immediately select first layout from the list.

You can also specify the behavior of the CapsLock key using variable *CAPS-LOCK-BEHAVIOR*. Available are the following values:

  • :normal - CapsLock serves as CapsLock
  • :ctrl - CapsLock serves as additional Ctrl
  • :swapped - CapsLock and Ctrl are swapped
  • :leave-alone - do not change CapsLock with setxkbmap

Add for example:

(setf kbd-layouts:*caps-lock-behavior* :leave-alone)

Note: If you do change *CAPS-LOCK-BEHAVIOR* add the call before the call to KEYBOARD-LAYOUT-LIST in your config file, to have it affect the initial configuration of your keyboard.

By default the command SWITCH-KEYBOARD-LAYOUT is bound to the key combination s-SPC (WinKey-Space).