The Genesis

AKLM was born out of frustration while playing a game on Linux. The game was hardcoded to use the US keyboard layout with no option to change keymapping. For someone using an alternative layout (like Bépo or Dvorak), this made the game nearly unplayable.

AKLM solves this problem by automatically switching your keyboard layout based on which window has focus. Launch your game? AKLM switches to US. Go back to Firefox? Back to your preferred layout. It’s seamless and automatic.

Requirements

• Operating System: Linux with X11 (Xorg)

• Window Manager: i3 or i3-gaps

• Tools: setxkbmap (usually pre-installed)

• Python: 3.10 or later

Dependencies:

• i3ipc - for communicating with i3 window manager

Configuration File Format

Create ~/.config/aklm/aklm.ini with the following structure:

[general]
default_layout = fr bepo
setxkbmap = /usr/bin/setxkbmap

[log]
level = info

[layout]
firefox = fr
code = en
factorio = us
Steam = us
discord = fr bepo

Configuration Sections

[general]

• default_layout: The keyboard layout to use when no specific mapping is found. Format: language variant (e.g., fr bepo, us, de nodeadkeys)

• setxkbmap: Full path to the setxkbmap binary (default: /usr/bin/setxkbmap)

[log]

• level: Logging verbosity. Options: error, warning, info, debug

[layout]

This section maps window classes to keyboard layouts. Each line follows the format:

window_class = layout

• window_class: The WM_CLASS property of the application window

• layout: The keyboard layout to use (same format as default_layout)

Finding Window Classes

To find the WM_CLASS of any window, use the xprop utility:

1. Run xprop in a terminal

2. Click on the window you want to identify

3. Look for the WM_CLASS line in the output

$ xprop | grep WM_CLASS
WM_CLASS(STRING) = "code", "Code"

The second value (Code in this example) is what you should use in your configuration.

Common Window Classes:

• Firefox: firefox

• VS Code: code

• Terminal (many): Alacritty, Terminator, Xterm

• Steam: Steam

• Discord: discord

Running AKLM

Start AKLM manually:

aklm

Or add it to your i3 configuration to start automatically:

# ~/.config/i3/config
exec --no-startup-id aklm

Running as a Systemd Service

For a more robust setup, create a systemd user service at ~/.config/systemd/user/aklm.service:

[Unit]
Description=Automatic Layout Manager
After=graphical-session.target

[Service]
Type=simple
ExecStart=/usr/bin/aklm
Restart=on-failure

[Install]
WantedBy=graphical-session.target

Then enable and start it:

systemctl --user enable --now aklm

Example 1: Multilingual Developer

A French developer using Bépo layout who needs US layout for gaming:

[general]
default_layout = fr bepo

[layout]
code = us
terminal = fr bepo
firefox = fr
Steam = us
factorio = us

Example 2: Documentation Writer

Someone who writes in multiple languages:

[general]
default_layout = us

[layout]
firefox = fr
libreoffice-writer = de
thunderbird = us

Layout Not Switching

1. Check if AKLM is running: ps aux | grep aklm

2. Verify window class: Use xprop to confirm the actual window class

3. Check logs: Run AKLM with debug logging:

   [log]
   level = debug

4. Test setxkbmap manually: setxkbmap fr to ensure it works

i3 Connection Issues

Ensure i3 IPC socket is accessible. Check that your i3 is running properly:

i3-msg -t get_version