Skip to content

Manual Install Linux

Enes Genç edited this page Nov 2, 2026 · 1 revision

Download

Download TRKEY-linux.tar.gz from the latest release and extract it:

tar -xzf TRKEY-linux.tar.gz

You get:

  • xkb/symbols/trkey: the layout
  • xkb/rules/evdev.xml: the entry that lists it in layout settings

Wayland

  1. Copy the layout into your user xkb folder:

    mkdir -p ~/.config/xkb/symbols ~/.config/xkb/rules
    cp xkb/symbols/trkey ~/.config/xkb/symbols/
  2. Register it so layout settings can list it.

    • If ~/.config/xkb/rules/evdev.xml doesn't exist, copy TRKEY's evdev.xml:

      cp xkb/rules/evdev.xml ~/.config/xkb/rules/
    • If it already exists (you have other custom layouts), open both files. Copy the <layout>…</layout> block from TRKEY's evdev.xml into yours, inside <layoutList>.

  3. Log out and back in. This is needed the first time, because the desktop only looks for ~/.config/xkb at login.

  4. Add the layout:

    • KDE Plasma: System Settings → Keyboard → Layouts → Add → TRKEY (US)
    • GNOME: Settings → Keyboard → Input Sources → + → Turkish → TRKEY (US)

If it isn't listed

You can set it by name instead.

  • KDE Plasma: in ~/.config/kxkbrc, add trkey to LayoutList, then log out and back in:

    [Layout]
    Use=true
    LayoutList=trkey,us
  • GNOME: this replaces your list of input sources, so keep any others you use:

    gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'trkey'), ('xkb', 'us')]"

X11

X11 only reads layouts from the system folder.

  1. Copy the layout there:

    sudo cp xkb/symbols/trkey /usr/share/X11/xkb/symbols/trkey
    sudo chmod 644 /usr/share/X11/xkb/symbols/trkey
  2. Select it.

    • For the current session:

      setxkbmap trkey
    • Permanently, for all X11 sessions: create /etc/X11/xorg.conf.d/00-trkey.conf with

      Section "InputClass"
          Identifier "trkey"
          MatchIsKeyboard "on"
          Option "XkbLayout" "trkey"
      EndSection
      

      then log out and back in.

Uninstall

  1. Switch to another layout and remove TRKEY (US) from your layout settings (or from kxkbrc / gsettings / xorg.conf.d if you set it there).

  2. Remove the files:

    rm -f ~/.config/xkb/symbols/trkey
    sudo rm -f /usr/share/X11/xkb/symbols/trkey   # only if you did the X11 steps
  3. Open ~/.config/xkb/rules/evdev.xml and delete the <layout> block containing <name>trkey</name>. You can delete the file if TRKEY is the only layout in it.

Home

Manual Install

Clone this wiki locally