Custom Keyboard Layout

  1. Download or create a custom keyboard layout. See /usr/share/X11/xkb/symbols for examples.
  2. Create ~/.config/xkb/symbols and ~/.config/xkb/rules.
  3. Move your layout file without extension to /symbols.
  4. in /symbols, create an evdev file with the following content:
! option   = symbols
layout_name:basic  = +layout_name(basic)

! include %S/evdev
  1. Create an evdev.xml file with the following content:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xkbConfigRegistry SYSTEM "xkb.dtd">
<xkbConfigRegistry version="1.1">
  <layoutList>
    <layout>
      <configItem>
        <name>layout_name</name>
        <shortDescription>2-letter description</shortDescription>
        <description>Layout Name</description>
        <countryList>
          <iso3166Id>2-letter Language code (UK) etc.</iso3166Id>
        </countryList>
        <languageList>
          <iso639Id>3-letter language code (eng) </iso639Id>
        </languageList>
      </configItem>
    </layout>
  </layoutList>
</xkbConfigRegistry>

This page was last edited on 2025-10-30 16:43

Powered by Wiki|Docs

This page was last edited on 2025-10-30 16:43

clippy
?

Powered by Wiki|Docs