XKEYBOARD-CONFIG(7)

📦

version 2.49 · 7 versions

2.49 · arch rolling (latest)
2.47 · nixos 26.05
2.48 · nixpkgs unstable
2.48 · ubuntu stonking
2.45 · fedora 43
2.47 · alpine 3.24, fedora 44
2.46 · alpine 3.23, fedora 43, ubuntu resolute

💫 xkeyboard-config — XKB data description files 💫

okay bestie, so this is XKEYBOARD-CONFIG(7)</p> — Miscellaneous Information Manual energy — and it's literally the glow-up guide for your keyboard's whole personality. Let's get into it 🎀

✨ NAME ✨

xkeyboard-config</p> — the XKB data description files. that's it, that's the name, she's iconic 💅

🌸 DESCRIPTION 🌸

okay so xkeyboard-config</p> ships the description files for the X Keyboard Extension (XKB) and for libxkbcommon. no cap, that's the whole job.

and like — usually it's the desktop environment's moment to shine ✨, because applying the configuration you asked for is typically their task. main character energy, honestly.

if you're running an X server you've got options too, bestie:

you can use the setxkbmap(1) tool to apply keyboard configuration at runtime 🔥
or you can configure XKB settings in xorg.conf(5)

both valid, both slay, pick your vibe 🫶

🦋 XKB DATA FILES LOAD PATHS 🦋

so xkeyboard-config provides the XKB data files, and they're installed in:

/usr/share/xkeyboard-config-2

user-specific data files may live somewhere else, but — and this is the tea ☕ — it depends on the tool whether those files actually get loaded. so don't come for me if your tool ghosts your custom path, okay? 😭

for example (fr fr), the libxkbcommon library will by default load XKB data files from the user's home directory 🏠. see the libxkbcommon documentation for the details, bestie — that's where the fine print lives 💜

🎀 THE CUSTOM LAYOUT 🎀

okay this part is lowkey my fave because it's giving exclusive but not really 💀

the "custom" layout is a layout that's listed as available to tools reading the data files — but it's not actually provided by xkeyboard-config. she's on the guest list but she didn't bring the snacks, iykyk 🙈

so what's the move? you, bestie, may save a layout specification in this file:

/usr/share/xkeyboard-config-2/symbols/custom

and then that layout will be available to most tools interacting with the xkeyboard-config data files. boom. your own lil layout, living her life 🌈

this is primarily aimed at systems running X where additional lookup paths cannot easily be added. like, the system can't easily expand its friend group, so we're sneaking you in through the side door 🧚

and because the "custom" layout is merely listed as available but not provided by xkeyboard-config, your layout will not be overwritten on updates 👑✨ — yes bestie, she survives the update apocalypse. periodt. 💖

lowkey the most important glow-up here: updates won't touch your custom file, so your work is safe. cherish her. 🍓

✨ MODELS ✨

Okay bestie, so this is the big one — the MODELS list. Every single one of these names is a model you can name-drop, and each one maps to a specific hunk of keyboard plastic and the way its keys are physically laid out. Think of it as a guest list: if your keyboard isn't on it, the party doesn't know it yet. 🎉

No cap, there are a LOT of them. Go get a snack. 🍓

pc86 — Generic 86-key PC
pc101 — Generic 101-key PC
pc102 — Generic 102-key PC
pc104 — Generic 104-key PC
pc104alt — Generic 104-key PC with L-shaped Enter key
pc105 — Generic 105-key PC
a4techKB21 — A4Tech KB-21
a4techKBS8 — A4Tech KBS-8
a4_rfkb23 — A4Tech Wireless Desktop RFKB-23
airkey — Acer AirKey V
acer_c300 — Acer C300
acer_ferrari4k — Acer Ferrari 4000
acer_laptop — Acer laptop
scorpius — Advance Scorpius KI
apple — Apple
applealu_ansi — Apple Aluminium (ANSI)
applealu_iso — Apple Aluminium (ISO)
applealu_jis — Apple Aluminium (JIS)
asus_laptop — Asus laptop
azonaRF2300 — Azona RF2300 Wireless Internet
benqx — BenQ X-Touch
benqx730 — BenQ X-Touch 730
benqx800 — BenQ X-Touch 800
abnt2 — Brazilian ABNT2
blackberry-key2 — BlackBerry KEY2
brother — Brother Internet
btc5090 — BTC 5090
btc5113rf — BTC 5113RF Multimedia
btc5126t — BTC 5126T
btc6301urf — BTC 6301URF
btc9000 — BTC 9000
btc9000a — BTC 9000A
btc9001ah — BTC 9001AH
btc9019u — BTC 9019U
btc9116u — BTC 9116U Mini Wireless Internet and Gaming
cherryblue — Cherry Blue Line CyBo@rd
cherrybluea — Cherry Blue Line CyBo@rd (alt.)
cherrybunlim — Cherry B.UNLIMITED
cherrycyboard — Cherry CyBo@rd USB-Hub
cherrycmexpert — Cherry CyMotion Expert
cymotionlinux — Cherry CyMotion Master Linux
cherryblueb — Cherry CyMotion Master XPress
chicony — Chicony Internet
chicony9885 — Chicony KB-9885
chicony0108 — Chicony KU-0108
chicony0420 — Chicony KU-0420
chromebook — Chromebook
compalfl90 — Compal FL90
armada — Compaq Armada laptop
compaqeak8 — Compaq Easy Access
compaqik7 — Compaq Internet (7 keys)
compaqik13 — Compaq Internet (13 keys)
compaqik18 — Compaq Internet (18 keys)
ipaq — Compaq iPaq
presario — Compaq Presario laptop
creativedw7000 — Creative Desktop Wireless 7000
dell — Dell
dell101 — Dell 101-key PC
latitude — Dell Latitude laptop
inspiron — Dell Inspiron 6000/8000 laptop
precision_m — Dell Precision M laptop
dellm65 — Dell Precision M65 laptop
dellsk8125 — Dell SK-8125
dellsk8135 — Dell SK-8135
dellusbmm — Dell USB Multimedia
dexxa — Dexxa Wireless Desktop
diamond — Diamond 9801/9802
dtk2000 — DTK2000
emachines — eMachines m6800 laptop
ennyah_dkb1008 — Ennyah DKB-1008
everex — Everex STEPnote
fscaa1667g — Fujitsu-Siemens Amilo laptop
genius — Genius Comfy KB-16M/Multimedia KWD-910
geniuscomfy — Genius Comfy KB-12e
geniuscomfy2 — Genius Comfy KB-21e-Scroll
geniuskb19e — Genius KB-19e NB
geniuskkb2050hs — Genius KKB-2050HS
gyration — Gyration
hhk — Happy Hacking
hpi6 — Hewlett-Packard Internet
hpmini110 — Hewlett-Packard Mini 110 laptop
hpnx9020 — Hewlett-Packard nx9020
hp5xx — Hewlett-Packard Omnibook 500
hp500fa — Hewlett-Packard Omnibook 500 FA
hp6000 — Hewlett-Packard Omnibook 6000/6100
hpxe3gc — Hewlett-Packard Omnibook XE3 GC
hpxe3gf — Hewlett-Packard Omnibook XE3 GF
hpxt1000 — Hewlett-Packard Omnibook XT1000
hpdv5 — Hewlett-Packard Pavilion dv5
hpzt11xx — Hewlett-Packard Pavilion ZT1100
hp250x — Hewlett-Packard SK-2501 Multimedia
honeywell_euroboard — Honeywell Euroboard
rapidaccess — IBM Rapid Access
rapidaccess2 — IBM Rapid Access II
ibm_spacesaver — IBM Space Saver
thinkpad — IBM ThinkPad 560Z/600/600E/A22E
thinkpad60 — IBM ThinkPad R60/T60/R61/T61
thinkpadz60 — IBM ThinkPad Z60m/Z60t/Z61m/Z61t
jp106 — Japanese 106-key
flexpro — Keytronic FlexPro
kinesis — Kinesis
kr106 — Korean 106-key
logitech_base — Logitech
logiaccess — Logitech Access
logicd — Logitech Cordless Desktop
logicda — Logitech Cordless Desktop (alt.)
logiex110 — Logitech Cordless Desktop EX110
logicd_it — Logitech Cordless Desktop iTouch
logiclx300 — Logitech Cordless Desktop LX-300
logicd_nav — Logitech Cordless Desktop Navigator
logicd_opt — Logitech Cordless Desktop Optical
logidinovo — Logitech diNovo
logidinovoedge — Logitech diNovo Edge
logitech_g15 — Logitech G15 extra keys via G15daemon
logiik — Logitech Internet
logii350 — Logitech Internet 350
logimel — Logitech Internet 350
logicink — Logitech Internet Navigator
itouch — Logitech iTouch
logiitc — Logitech iTouch Cordless Y-RB6
logiinkse — Logitech iTouch Internet Navigator SE
logiinkseusb — Logitech iTouch Internet Navigator SE USB
logiultrax — Logitech Ultra-X
logiultraxc — Logitech Ultra-X Cordless Media Desktop
mx1998 — Memorex MX1998
mx2500 — Memorex MX2500 EZ-Access
mx2750 — Memorex MX2750
microsoftccurve2k — Microsoft Comfort Curve 2000
microsoftinet — Microsoft Internet
microsoftprose — Microsoft Internet Pro (Swedish)
microsoft — Microsoft Natural
microsoftelite — Microsoft Natural Elite
microsoft4000 — Microsoft Natural Ergonomic 4000
microsoft7000 — Microsoft Natural Wireless Ergonomic 7000
microsoftpro — Microsoft Natural Pro/Internet Pro
microsoftprousb — Microsoft Natural Pro USB/Internet Pro

A few little moments I need to point at, because they're sending me:

pc104alt is the generic 104-key but with an L-shaped Enter key — that's its whole personality and honestly, valid. 👑
The Apple aluminium trio is a whole set: applealu_ansi, applealu_iso, applealu_jis — three flavours of the same vibe, pick your regional icon. 🍎
cherryblue, cherrybluea, and cherrycyboard all rock the CyBo@rd spelling with the @ — do not "correct" it when you type it, the @ is load-bearing. 💅
logii350 and logimel both list Logitech Internet 350 as their description. Not a typo on my end, both are right there. 🫶
logitech_g15 is described as Logitech G15 extra keys via G15daemon — that daemon mention is literally part of the description, so it stays. ✨
hhk = Happy Hacking, which is just the most main-character name in the entire list and I don't make the rules. 🧚

That's the full model roster, every last one, in the same order as ever. 💖

microsoftprooem — Microsoft Natural Pro OEM 🌸
microsoftoffice — Microsoft Office Keyboard
microsoftsurface — Microsoft Surface
microsoftmult — Microsoft Wireless Multimedia 1.0A
sk1300 — NEC SK-1300
sk2500 — NEC SK-2500
sk6200 — NEC SK-6200
sk7100 — NEC SK-7100
omnikey101 — Northgate OmniKey 101
olpc — OLPC ✨
oretec — Ortek Multimedia/Internet MCK-800
pc98 — PC-98
ppkb — PinePhone Keyboard 🌈
propeller — Propeller Voyager KTEZ-1000
qtronix — QTronix Scorpius 98N+
samsung4500 — Samsung SDM 4500P
samsung4510 — Samsung SDM 4510P
sanwaskbkg3 — Sanwa Supply SKB-KG3
silvercrest — Silvercrest Multimedia Wireless
apex300 — SteelSeries Apex 300 (Apex RAW) 🔥
sun_type6_jp — Sun Type 6 (Japanese)
sun_type6_jp_usb — Sun Type 6 USB (Japanese)
sun_type6_unix_usb — Sun Type 6 USB (Unix)
sun_type6_usb — Sun Type 6/7 USB
sun_type6_euro_usb — Sun Type 6/7 USB (European)
sun_type7_usb — Sun Type 7 USB
sun_type7_euro_usb — Sun Type 7 USB (European)
sun_type7_jp_usb — Sun Type 7 USB (Japanese)/Japanese 106-key
sun_type7_unix_usb — Sun Type 7 USB (Unix)
sp_inet — Super Power Multimedia
sven — SVEN Ergonomic 2500
sven303 — SVEN Slim 303
symplon — Symplon PaceBook tablet 💅
targa_v811 — Targa Visionary 811
toshiba_s3000 — Toshiba Satellite S3000
teck227 — Truly Ergonomic 227
teck229 — Truly Ergonomic 229
trustda — Trust Direct Access
trust_slimline — Trust Slimline
trust — Trust Wireless Classic
tm2020 — TypeMatrix EZ-Reach 2020
tm2030PS2 — TypeMatrix EZ-Reach 2030 PS2
tm2030USB — TypeMatrix EZ-Reach 2030 USB
tm2030USB-102 — TypeMatrix EZ-Reach 2030 USB (102/105:EU mode)
tm2030USB-106 — TypeMatrix EZ-Reach 2030 USB (106:JP mode)
unitekkb1925 — Unitek KB-1925
vsonku306 — ViewSonic KU-306 Internet
winbook — Winbook Model XP5
yahoo — Yahoo! Internet 🦋

And that's a wrap on the model roster — like, that's the whole alphabet soup of keyboards the rules file knows about, bestie. If your board's name is in there, you're literally set. 💖

🌍 LAYOUTS

okay bestie, this is the big one — the master list of every layout and variant you can drop into ${layout}(${variant}) form. Each bullet is a base layout code, and the lil' indented ones under it are the variants (that's the (whatever) bit in the parens). Descriptions are right there next to each one so you know exactly what vibe you're typing in. No cap, it's a long list — go get a snack. 🍓

al — Albanian
- al(plisi) — Albanian (Plisi)
- al(veqilharxhi) — Albanian (Veqilharxhi)
et — Amharic
am — Armenian
- am(phonetic) — Armenian (phonetic)
- am(phonetic-alt) — Armenian (alt. phonetic)
- am(eastern) — Armenian (eastern)
- am(eastern-alt) — Armenian (alt. eastern)
- am(western) — Armenian (western)
ara — Arabic
- ara(digits) — Arabic (Eastern Arabic numerals)
- ara(azerty) — Arabic (AZERTY)
- ara(azerty_digits) — Arabic (AZERTY, Eastern Arabic numerals)
- ara(buckwalter) — Arabic (Buckwalter)
- ara(mac) — Arabic (Macintosh)
- ara(mac-phonetic) — Arabic (Macintosh, phonetic)
- ara(olpc) — Arabic (OLPC)
eg — Arabic (Egypt)
iq — Arabic (Iraq)
- iq(ku) — Kurdish (Iraq, Latin Q)
- iq(ku_alt) — Kurdish (Iraq, Latin Alt-Q)
- iq(ku_f) — Kurdish (Iraq, F)
- iq(ku_ara) — Kurdish (Iraq, Arabic-Latin)
ma — Arabic (Morocco)
- ma(tifinagh) — Berber (Morocco, Tifinagh)
- ma(tifinagh-alt) — Berber (Morocco, Tifinagh alt.)
- ma(tifinagh-alt-phonetic) — Berber (Morocco, Tifinagh phonetic, alt.)
- ma(tifinagh-extended) — Berber (Morocco, Tifinagh extended)
- ma(tifinagh-phonetic) — Berber (Morocco, Tifinagh phonetic)
- ma(tifinagh-extended-phonetic) — Berber (Morocco, Tifinagh extended phonetic)
- ma(french) — French (Morocco)
- ma(rif) — Tarifit
sy — Arabic (Syria)
- sy(syc) — Syriac
- sy(syc_phonetic) — Syriac (phonetic)
- sy(ku) — Kurdish (Syria, Latin Q)
- sy(ku_alt) — Kurdish (Syria, Latin Alt-Q)
- sy(ku_f) — Kurdish (Syria, F)
az — Azerbaijani
- az(cyrillic) — Azerbaijani (Cyrillic)
- az(standard) — Azerbaijani (standard)
ml — Bambara
- ml(fr-oss) — French (Mali, alt.)
- ml(us-mac) — English (Mali, US, Macintosh)
- ml(us-intl) — English (Mali, US, intl.)
bd — Bangla
- bd(probhat) — Bangla (Probhat)
by — Belarusian
- by(legacy) — Belarusian (legacy)
- by(latin) — Belarusian (Latin)
- by(intl) — Belarusian (intl.)
- by(phonetic) — Belarusian (phonetic)
- by(typographic) — Belarusian (typo.)
- by(ru) — Russian (Belarus)
be — Belgian
- be(oss) — Belgian (alt.)
- be(oss_latin9) — Belgian (Latin-9 only, alt.)
- be(iso-alternate) — Belgian (ISO, alt.)
- be(nodeadkeys) — Belgian (no dead keys)
- be(wang) — Belgian (Wang 724 AZERTY)
dz — Berber (Algeria, Latin)
- dz(ber) — Berber (Algeria, Tifinagh)
- dz(azerty-deadkeys) — Kabyle (AZERTY, with dead keys)
- dz(qwerty-gb-deadkeys) — Kabyle (QWERTY, UK, with dead keys)
- dz(qwerty-us-deadkeys) — Kabyle (QWERTY, US, with dead keys)
- dz(ar) — Arabic (Algeria)
ba — Bosnian
- ba(alternatequotes) — Bosnian (with guillemets)
- ba(unicode) — Bosnian (with Bosnian digraphs)
- ba(unicodeus) — Bosnian (US, with Bosnian digraphs)

and yes the list keeps going, we're only like halfway down the alphabet 💀 stay with me bestie 🫶

ba(us) — Bosnian (US) 🦋

okay next up is the Braille corner of the keyboard world and it is so cool that these even exist 💖 five whole variants, one for each hand, and yes there's an "inverted thumb" option because of course there is:

brai — Braille
brai(left_hand) — Braille (one-handed, left)
brai(left_hand_invert) — Braille (one-handed, left, inverted thumb)
brai(right_hand) — Braille (one-handed, right)
brai(right_hand_invert) — Braille (one-handed, right, inverted thumb)

then we slide into Bulgarian 🇧🇬 and she has opinions about phonetics:

bg — Bulgarian
bg(phonetic) — Bulgarian (traditional phonetic)
bg(bas_phonetic) — Bulgarian (new phonetic)
bg(bekl) — Bulgarian (enhanced)

Burmese time, and this group is genuinely stacked — scripts on scripts on scripts 😭✨:

mm — Burmese
mm(zawgyi) — Burmese (Zawgyi)
mm(mara) — Mara
mm(mnw) — Mon
mm(mnw-a1) — Mon (A1)
mm(shn) — Shan
mm(zgt) — Shan (Zawgyi)

Chinese, and bestie this one is a journey — pinyin, Mongolian in like six different flavours, Tibetan, Uyghur, all chillin' under cn 👑:

cn — Chinese
cn(altgr-pinyin) — Hanyu Pinyin Letters (with AltGr dead keys)
cn(mon_trad) — Mongolian (Bichig)
cn(mon_trad_todo) — Mongolian (Todo)
cn(mon_trad_xibe) — Mongolian (Xibe)
cn(mon_trad_manchu) — Mongolian (Manchu)
cn(mon_trad_galik) — Mongolian (Galik)
cn(mon_todo_galik) — Mongolian (Todo Galik)
cn(mon_manchu_galik) — Mongolian (Manchu Galik)
cn(tib) — Tibetan
cn(tib_asciinum) — Tibetan (with ASCII numerals)
cn(ug) — Uyghur

Croatian next — guillemets, digraphs, the US crossover, the whole aesthetic 💅:

hr — Croatian
hr(alternatequotes) — Croatian (with guillemets)
hr(unicode) — Croatian (with Croatian digraphs)
hr(unicodeus) — Croatian (US, with Croatian digraphs)
hr(us) — Croatian (US)

Czech, and ngl this list goes hard — QWERTY, QWERTZ, Windows, Mac, UCW, Dvorak, and a Russian phonetic one just vibing at the bottom 🔥:

cz — Czech
cz(bksl) — Czech (extra backslash)
cz(qwerty) — Czech (QWERTY)
cz(qwerty_bksl) — Czech (QWERTY, extra backslash)
cz(winkeys) — Czech (QWERTZ, Windows)
cz(winkeys-qwerty) — Czech (QWERTY, Windows)
cz(qwerty-mac) — Czech (QWERTY, Macintosh)
cz(ucw) — Czech (UCW, only accented letters)
cz(dvorak-ucw) — Czech (US, Dvorak, UCW support)
cz(rus) — Russian (Czechia, phonetic)

Danish 🇩🇰 — she's got dead keys, no dead keys, Windows, Mac, Mac without dead keys, and a Dvorak moment:

dk — Danish
dk(nodeadkeys) — Danish (no dead keys)
dk(winkeys) — Danish (Windows)
dk(mac) — Danish (Macintosh)
dk(mac_nodeadkeys) — Danish (Macintosh, no dead keys)
dk(dvorak) — Danish (Dvorak)

Dari, and the OLPC variants are giving "one laptop per child" main character energy 🎀:

af — Dari
af(ps) — Pashto
af(uz) — Uzbek (Afghanistan)
af(fa-olpc) — Dari (Afghanistan, OLPC)
af(ps-olpc) — Pashto (Afghanistan, OLPC)
af(uz-olpc) — Uzbek (Afghanistan, OLPC)

mv — Dhivehi 🌸

Dutch, short and sweet, love that for her:

nl — Dutch
nl(us) — Dutch (US)
nl(mac) — Dutch (Macintosh)
nl(std) — Dutch (standard)

bt — Dzongkha ⭐

au — English (Australia) 🦘

Cameroon, and she brought the whole multilingual friend group with her 🫶:

cm — English (Cameroon)
cm(french) — French (Cameroon)
cm(qwerty) — Cameroon Multilingual (QWERTY, intl.)
cm(azerty) — Cameroon (AZERTY, intl.)
cm(dvorak) — Cameroon (Dvorak, intl.)
cm(mmuock) — Mmuock

Ghana, and this group is a whole language family reunion — Akan, Avatime, Ewe, Fula, Ga, Hausa, all under gh:

gh — English (Ghana)
gh(generic) — English (Ghana, multilingual)
gh(gillbt) — English (Ghana, GILLBT)
gh(akan) — Akan
gh(avn) — Avatime
gh(ewe) — Ewe
gh(fula) — Fula
gh(ga) — Ga
gh(hausa) — Hausa (Ghana)
nz — English (New Zealand)
- nz(mao) — Maori

okay next up, Nigeria and South Africa, keep scrolling bestie we're getting through the whole alphabet 💅

ng — English (Nigeria)
- ng(hausa) — Hausa (Nigeria)
- ng(igbo) — Igbo
- ng(yoruba) — Yoruba

za — English (South Africa)

gb — English (UK)
- gb(extd) — English (UK, extended, Windows)
- gb(intl) — English (UK, intl., with dead keys)
- gb(dvorak) — English (UK, Dvorak)
- gb(dvorakukp) — English (UK, Dvorak, with UK punctuation)
- gb(mac) — English (UK, Macintosh)
- gb(mac_intl) — English (UK, Macintosh, intl.)
- gb(colemak) — English (UK, Colemak)
- gb(colemak_dh) — English (UK, Colemak-DH)
- gb(gla) — Scottish Gaelic
- gb(pl) — Polish (British keyboard)

and then there's the us one, which is literally the main character of this whole list — look at all these variants, she ate and left no crumbs 👑

us — English (US)
- us(euro) — English (US, euro on 5)
- us(intl) — English (US, intl., with dead keys)
- us(alt-intl) — English (US, alt. intl.)
- us(altgr-intl) — English (intl., with AltGr dead keys)
- us(mac) — English (Macintosh, ABC, ANSI)
- us(mac-iso) — English (Macintosh, ABC, ISO)
- us(colemak) — English (Colemak)
- us(colemak_dh) — English (Colemak-DH)
- us(colemak_dh_wide) — English (Colemak-DH Wide)
- us(colemak_dh_ortho) — English (Colemak-DH Ortholinear)
- us(colemak_dh_iso) — English (Colemak-DH ISO)
- us(colemak_dh_wide_iso) — English (Colemak-DH Wide ISO)
- us(dvorak) — English (Dvorak)
- us(dvorak-intl) — English (Dvorak, intl., with dead keys)
- us(dvorak-alt-intl) — English (Dvorak, alt. intl.)
- us(dvorak-l) — English (Dvorak, one-handed, left)
- us(dvorak-r) — English (Dvorak, one-handed, right)
- us(dvorak-classic) — English (classic Dvorak)
- us(dvp) — English (programmer Dvorak)
- us(dvorak-mac) — English (Dvorak, Macintosh, ANSI)
- us(dvorak-mac-iso) — English (Dvorak, Macintosh, ISO)
- us(norman) — English (Norman)
- us(symbolic) — English (US, Symbolic)
- us(workman) — English (Workman)
- us(workman-intl) — English (Workman, intl., with dead keys)
- us(olpc2) — English (the divide/multiply toggle the layout)
- us(chr) — Cherokee
- us(haw) — Hawaiian
- us(rus) — Russian (US, phonetic)
- us(hbs) — Serbo-Croatian (US)

epo — Esperanto
- epo(legacy) — Esperanto (legacy)

ee — Estonian
- ee(nodeadkeys) — Estonian (no dead keys)
- ee(dvorak) — Estonian (Dvorak)
- ee(us) — Estonian (US)

fo — Faroese
- fo(nodeadkeys) — Faroese (no dead keys)

ph — Filipino
- ph(qwerty-bay) — Filipino (QWERTY, Baybayin)
- ph(capewell-dvorak) — Filipino (Capewell-Dvorak, Latin)
- ph(capewell-dvorak-bay) — Filipino (Capewell-Dvorak, Baybayin)
- ph(capewell-qwerf2k6) — Filipino (Capewell-QWERF 2006, Latin)
- ph(capewell-qwerf2k6-bay) — Filipino (Capewell-QWERF 2006, Baybayin)
- ph(colemak) — Filipino (Colemak, Latin)
- ph(colemak-bay) — Filipino (Colemak, Baybayin)
- ph(dvorak) — Filipino (Dvorak, Latin)
- ph(dvorak-bay) — Filipino (Dvorak, Baybayin)

fi — Finnish
- fi(winkeys) — Finnish (Windows)
- fi(classic) — Finnish (classic)
- fi(nodeadkeys) — Finnish (classic, no dead keys)
- fi(mac) — Finnish (Macintosh)
- fi(smi) — Northern Saami (Finland)

fr — French
- fr(nodeadkeys) — French (no dead keys)
- fr(oss) — French (alt.)
- fr(oss_nodeadkeys) — French (alt., no dead keys)
- fr(oss_latin9) — French (alt., Latin-9 only)
- fr(latin9) — French (legacy, alt.)
- fr(latin9_nodeadkeys) — French (legacy, alt., no dead keys)
- fr(azerty) — French (AZERTY)
- fr(afnor) — French (AZERTY, AFNOR)
- fr(bepo) — French (BEPO)
- fr(bepo_latin9) — French (BEPO, Latin-9 only)
- fr(bepo_afnor) — French (BEPO, AFNOR)
- fr(dvorak) — French (Dvorak)

…and the fr fam wraps up like this, bestie:

fr(ergol) — French (Ergo‑L) — the ergo girlies are obsessed 💅
fr(ergol_iso) — French (Ergo‑L, ISO variant)
fr(mac) — French (Macintosh)
fr(us) — French (US)
fr(bre) — Breton (France)
fr(oci) — Occitan
fr(geo) — Georgian (France, AZERTY Tskapo)

🇨🇦 the `ca` girlies (yes there are several)

ca — French (Canada)
ca(fr-dvorak) — French (Canada, Dvorak)
ca(fr-legacy) — French (Canada, legacy)
ca(multix) — Canadian (CSA)
ca(eng) — English (Canada) 🍁
ca(ike) — Inuktitut

🌍 the little single-variant solo acts

cd — French (Democratic Republic of the Congo)
tg — French (Togo)

no variants, just vibes, and honestly? respect 🫶

🇬🇪 `ge`, aka Georgian station

ge — Georgian
ge(ergonomic) — Georgian (ergonomic)
ge(mess) — Georgian (MESS)
ge(os) — Ossetian (Georgia)
ge(ru) — Russian (Georgia)

🇩🇪 `de` — the German mothership, and she is huge

okay so de has main character energy and a million children, let's get through them all:

de — German
de(deadacute) — German (dead acute)
de(deadgraveacute) — German (dead grave acute)
de(deadtilde) — German (dead tilde)
de(nodeadkeys) — German (no dead keys) — for when the dead keys keep jumpscaring you 😭
de(e1) — German (E1)
de(e2) — German (E2)
de(T3) — German (T3)
de(us) — German (US)
de(dvorak) — German (Dvorak)
de(mac) — German (Macintosh)
de(mac_nodeadkeys) — German (Macintosh, no dead keys)
de(neo) — German (Neo 2)
de(qwerty) — German (QWERTY)
de(dsb) — Lower Sorbian
de(dsb_qwertz) — Lower Sorbian (QWERTZ)
de(ro) — Romanian (Germany)
de(ro_nodeadkeys) — Romanian (Germany, no dead keys)
de(ru) — Russian (Germany, phonetic)
de(tr) — Turkish (Germany)

🇦🇹 `at` — Austria said "we're also German, actually"

at — German (Austria)
at(nodeadkeys) — German (Austria, no dead keys)
at(mac) — German (Austria, Macintosh)

🇨🇭 `ch` — Switzerland, being multilingual and iconic as always

ch — German (Switzerland)
ch(de_nodeadkeys) — German (Switzerland, no dead keys)
ch(de_mac) — German (Switzerland, Macintosh)
ch(legacy) — German (Switzerland, legacy)
ch(fr) — French (Switzerland)
ch(fr_nodeadkeys) — French (Switzerland, no dead keys)
ch(fr_mac) — French (Switzerland, Macintosh)

🇬🇷 `gr` — Greek

gr — Greek
gr(simple) — Greek (simple)
gr(nodeadkeys) — Greek (no dead keys)
gr(polytonic) — Greek (polytonic)

🇮🇱 `il` — Hebrew

il — Hebrew
il(si2) — Hebrew (SI-1452-2)
il(lyx) — Hebrew (lyx)
il(phonetic) — Hebrew (phonetic)
il(biblical) — Hebrew (Biblical, Tiro)

🇭🇺 `hu` — Hungarian, and she brought a spreadsheet of variants

bestie, the Hungarian list is lowkey iconic — it's basically every combination of QWERTZ/QWERTY × 101/102-key × comma/dot × dead/nodead. And yes, every single one is in here. No skipping. 😤

the basics first:

hu — Hungarian
hu(standard) — Hungarian (standard)
hu(nodeadkeys) — Hungarian (no dead keys)
hu(qwerty) — Hungarian (QWERTY)

then the 101-key squad:

hu(101_qwertz_comma_dead) — Hungarian (QWERTZ, 101-key, comma, dead keys)
hu(101_qwertz_comma_nodead) — Hungarian (QWERTZ, 101-key, comma, no dead keys)
hu(101_qwertz_dot_dead) — Hungarian (QWERTZ, 101-key, dot, dead keys)
hu(101_qwertz_dot_nodead) — Hungarian (QWERTZ, 101-key, dot, no dead keys)
hu(101_qwerty_comma_dead) — Hungarian (QWERTY, 101-key, comma, dead keys)
hu(101_qwerty_comma_nodead) — Hungarian (QWERTY, 101-key, comma, no dead keys)
hu(101_qwerty_dot_dead) — Hungarian (QWERTY, 101-key, dot, dead keys)
hu(101_qwerty_dot_nodead) — Hungarian (QWERTY, 101-key, dot, no dead keys)

and the 102-key squad, same energy:

hu(102_qwertz_comma_dead) — Hungarian (QWERTZ, 102-key, comma, dead keys)
hu(102_qwertz_comma_nodead) — Hungarian (QWERTZ, 102-key, comma, no dead keys)
hu(102_qwertz_dot_dead) — Hungarian (QWERTZ, 102-key, dot, dead keys)
hu(102_qwertz_dot_nodead) — Hungarian (QWERTZ, 102-key, dot, no dead keys)
hu(102_qwerty_comma_dead) — Hungarian (QWERTY, 102-key, comma, dead keys)
hu(102_qwerty_comma_nodead) — Hungarian (QWERTY, 102-key, comma, no dead keys)
hu(102_qwerty_dot_dead) — Hungarian (QWERTY, 102-key, dot, dead keys)
hu(102_qwerty_dot_nodead) — Hungarian (QWERTY, 102-key, dot, no dead keys)

ok and remember the notation bestie: hu(102_qwerty_dot_nodead) is just the layout hu plus the variant 102_qwerty_dot_nodead — that's the whole pattern, every time. 🎀

🇮🇸 `is` — Icelandic (and the `is` key code confusion is not my problem today)

is — Icelandic
is(mac_legacy) — Icelandic (Macintosh, legacy)
is(mac) — Icelandic (Macintosh)
is(dvorak) — Icelandic (Dvorak)

still in the India block btw — this thing is long and we're not even done:

in — Indian
in(asm-kagapa) — Assamese (KaGaPa, phonetic)
in(ben) — Bangla (India)
in(ben_probhat) — Bangla (India, Probhat)
in(ben_baishakhi) — Bangla (India, Baishakhi)
in(ben_bornona) — Bangla (India, Bornona)
in(ben-kagapa) — Bangla (India, KaGaPa, phonetic)
in(ben_gitanjali) — Bangla (India, Gitanjali)
in(ben_inscript) — Bangla (India, Baishakhi InScript)
in(eng) — English (India, with rupee)
in(guj) — Gujarati
in(guj-kagapa) — Gujarati (KaGaPa, phonetic)
in(bolnagri) — Hindi (Bolnagri)
in(hin-wx) — Hindi (Wx)
in(hin-kagapa) — Hindi (KaGaPa, phonetic)
in(kan) — Kannada
in(kan-kagapa) — Kannada (KaGaPa, phonetic)
in(mal) — Malayalam
in(mal_lalitha) — Malayalam (Lalitha)
in(mal_enhanced) — Malayalam (enhanced InScript, with rupee)
in(mal_poorna) — Malayalam (Poorna, extended InScript)
in(mara) — Mara
in(mni) — Manipuri (Meitei)
in(mar-kagapa) — Marathi (KaGaPa, phonetic)
in(marathi) — Marathi (enhanced InScript)
in(ori) — Oriya
in(ori-bolnagri) — Oriya (Bolnagri)
in(ori-wx) — Oriya (Wx)
in(guru) — Punjabi (Gurmukhi)
in(jhelum) — Punjabi (Gurmukhi Jhelum)
in(san-kagapa) — Sanskrit (KaGaPa, phonetic)
in(sat) — Santali (Ol Chiki)
in(tamilnet) — Tamil (TamilNet '99)
in(tamilnet_tamilnumbers) — Tamil (TamilNet '99 with Tamil numerals)
in(tamilnet_TAB) — Tamil (TamilNet '99, TAB encoding)
in(tamilnet_TSCII) — Tamil (TamilNet '99, TSCII encoding)
in(tam) — Tamil (InScript, with Arabic numerals)
in(tam_tamilnumbers) — Tamil (InScript, with Tamil numerals)
in(tel) — Telugu
in(tel-kagapa) — Telugu (KaGaPa, phonetic)
in(tel-sarala) — Telugu (Sarala)
in(urd-phonetic) — Urdu (phonetic)
in(urd-phonetic3) — Urdu (alt. phonetic)
in(urd-winkeys) — Urdu (Windows)
in(iipa) — Indic IPA

that in(iipa) one at the bottom is serving Indic IPA realness, slay.

🇮🇩 Indonesian block, we move

id — Indonesian (Latin)
id(melayu-phonetic) — Indonesian (Arab Melayu, phonetic)
id(melayu-phoneticx) — Indonesian (Arab Melayu, extended phonetic)
id(pegon-phonetic) — Indonesian (Arab Pegon, phonetic)
id(javanese) — Javanese

🇮🇪 Irish, my beloved

ie — Irish
ie(UnicodeExpert) — Irish (UnicodeExpert)
ie(CloGaelach) — CloGaelach
ie(ogam) — Ogham
ie(ogam_is434) — Ogham (IS434)

bestie the Ogham layouts are literally ancient-script energy, we love a historical moment 💅

🇮🇹 Italian

it — Italian
it(nodeadkeys) — Italian (no dead keys)
it(winkeys) — Italian (Windows)
it(mac) — Italian (Macintosh)
it(us) — Italian (US)
it(ibm) — Italian (IBM 142)
it(fur) — Friulian (Italy)
it(scn) — Sicilian
it(geo) — Georgian (Italy)

not it(geo) being Georgian but in Italy 😭 the crossover episode nobody asked for but we're here for it.

🇯🇵 Japanese

jp — Japanese
jp(kana) — Japanese (Kana)
jp(OADG109A) — Japanese (OADG 109A)
jp(mac) — Japanese (Macintosh)
jp(dvorak) — Japanese (Dvorak)

🇰🇿 Kazakh

kz — Kazakh
kz(kazrus) — Kazakh (with Russian)
kz(ext) — Kazakh (extended)
kz(latin) — Kazakh (Latin)
kz(ruskaz) — Russian (Kazakhstan, with Kazakh)

heads up that kz(ruskaz) is filed under Russian, not Kazakh — it's the Russian layout for Kazakhstan with Kazakh support. read the label, bestie 🫶

🇰🇭 Khmer

kh — Khmer (Cambodia)

one (1) layout. iconic minimalist behaviour, we respect it. ✨

🇰🇷 Korean

kr — Korean
kr(kr104) — Korean (101/104-key compatible)

🇰🇬 Kyrgyz

kg — Kyrgyz
kg(phonetic) — Kyrgyz (phonetic)

🇱🇦 Lao

la — Lao
la(stea) — Lao (STEA)

🇱🇻 Latvian — okay this one has range

lv — Latvian
lv(apostrophe) — Latvian (apostrophe)
lv(tilde) — Latvian (tilde)
lv(fkey) — Latvian (F)
lv(modern) — Latvian (Modern Latin)
lv(modern-cyr) — Latvian (Modern Cyrillic)
lv(ergonomic) — Latvian (ergonomic, ŪGJRMV)
lv(adapted) — Latvian (adapted)

note the ŪGJRMV in lv(ergonomic) — that's macron-U, G, J, R, M, V, and yes it's written exactly like that, don't come for me. Latvian really said "we have options" and honestly? correct. 🌸

🇱🇹 `lt` — Lithuanian

lt — Lithuanian, the plain one, no variant needed 💅
lt(std) — Lithuanian (standard)
lt(us) — Lithuanian (US)
lt(ibm) — Lithuanian (IBM)
lt(lekp) — Lithuanian (LEKP)
lt(lekpa) — Lithuanian (LEKPa)
lt(ratise) — Lithuanian (Ratise)
lt(sgs) — Samogitian

🇲🇰 `mk` — Macedonian

mk — Macedonian
mk(nodeadkeys) — Macedonian (no dead keys) — for when dead keys are giving you grief 😭

🇲🇾 `my` — Malay (Jawi, Arabic Keyboard)

my — Malay (Jawi, Arabic Keyboard)
my(phonetic) — Malay (Jawi, phonetic)

🇲🇹 `mt` — Maltese

mt — Maltese
mt(us) — Maltese (US)
mt(alt-us) — Maltese (US, with AltGr overrides)
mt(alt-gb) — Maltese (UK, with AltGr overrides)

🇲🇩 `md` — Moldavian

md — Moldavian
md(gag) — Gagauz (Moldova)

🇲🇳 `mn` — Mongolian

mn — Mongolian, that's it, one and done, no variants ✨

🇲🇪 `me` — Montenegrin

me — Montenegrin
me(cyrillic) — Montenegrin (Cyrillic)
me(cyrillicyz) — Montenegrin (Cyrillic, ZE and ZHE swapped)
me(cyrillicalternatequotes) — Montenegrin (Cyrillic, with guillemets)
me(latinunicode) — Montenegrin (Latin, Unicode)
me(latinyz) — Montenegrin (Latin, QWERTY)
me(latinunicodeyz) — Montenegrin (Latin, Unicode, QWERTY)
me(latinalternatequotes) — Montenegrin (Latin, with guillemets)

🇳🇵 `np` — Nepali

np — Nepali, solo entry, she's lowkey iconic on her own 🫶

`gn` — N'Ko (AZERTY)

gn — N'Ko (AZERTY)

🇳🇴 `no` — Norwegian

okay this one is stacked, bestie, buckle up 🎀

no — Norwegian
no(nodeadkeys) — Norwegian (no dead keys)
no(winkeys) — Norwegian (Windows)
no(mac) — Norwegian (Macintosh)
no(mac_nodeadkeys) — Norwegian (Macintosh, no dead keys)
no(colemak) — Norwegian (Colemak)
no(colemak_dh) — Norwegian (Colemak-DH)
no(colemak_dh_wide) — Norwegian (Colemak-DH Wide)
no(dvorak) — Norwegian (Dvorak)
no(smi) — Northern Saami (Norway)
no(smi_nodeadkeys) — Northern Saami (Norway, no dead keys)

🇮🇷 `ir` — Persian

ir — Persian
ir(pes_keypad) — Persian (with Persian keypad) — numeric keypad said "me too" 🔥
ir(winkeys) — Persian (Windows)
ir(azb) — Azerbaijani (Iran)
ir(ku) — Kurdish (Iran, Latin Q)
ir(ku_alt) — Kurdish (Iran, Latin Alt-Q)
ir(ku_f) — Kurdish (Iran, F)
ir(ku_ara) — Kurdish (Iran, Arabic-Latin)

🇵🇱 `pl` — Polish

pl — Polish
pl(legacy) — Polish (legacy)
pl(qwertz) — Polish (QWERTZ)
pl(dvorak) — Polish (Dvorak)
pl(dvorak_quotes) — Polish (Dvorak, with Polish quotes on quotemark key)
pl(dvorak_altquotes) — Polish (Dvorak, with Polish quotes on key 1)
pl(dvp) — Polish (programmer Dvorak)
pl(csb) — Kashubian
pl(szl) — Silesian
pl(ru_phonetic_dvorak) — Russian (Poland, phonetic Dvorak)

🇵🇹 `pt` — Portuguese

pt — Portuguese
pt(nodeadkeys) — Portuguese (no dead keys)
pt(mac) — Portuguese (Macintosh)
pt(mac_nodeadkeys) — Portuguese (Macintosh, no dead keys)
pt(nativo) — Portuguese (Nativo)
pt(nativo-us) — Portuguese (Nativo for US keyboards)
pt(nativo-epo) — Esperanto (Portugal, Nativo) — plot twist: Esperanto showed up 🇪🇸✨

🇧🇷 `br` — Portuguese (Brazil)

br — Portuguese (Brazil)
br(nodeadkeys) — Portuguese (Brazil, no dead keys)
br(dvorak) — Portuguese (Brazil, Dvorak)
br(nativo) — Portuguese (Brazil, Nativo)
br(nativo-us) — Portuguese (Brazil, Nativo for US keyboards)
br(thinkpad) — Portuguese (Brazil, IBM/Lenovo ThinkPad)
br(thinkpad_nodeadkeys) — Portuguese (Brazil, IBM/Lenovo ThinkPad, no dead keys)
br(nativo-epo) — Esperanto (Brazil, Nativo)
br(rus) — Russian (Brazil, phonetic)

🇷🇴 `ro` — Romanian

ro — Romanian

okay that's where this part cuts off, but ro has more variants coming, hold the thought 💜

Still in the layout list, bestie — we're deep in the alphabet now and there's so much here. Keep scrolling, it's all right here 💅

ro(std) — Romanian (standard)
ro(winkeys) — Romanian (Windows)

Okay so Russia came to serve — this is the biggest cluster on the whole list, no cap 🇷🇺✨

ru — Russian
ru(phonetic) — Russian (phonetic)
ru(phonetic_winkeys) — Russian (phonetic, Windows)
ru(phonetic_YAZHERTY) — Russian (phonetic, YAZHERTY)
ru(phonetic_azerty) — Russian (phonetic, AZERTY)
ru(phonetic_dvorak) — Russian (phonetic, Dvorak)
ru(typewriter) — Russian (typewriter)
ru(ruchey_ru) — Russian (engineering, RU)
ru(ruchey_en) — Russian (engineering, EN)
ru(legacy) — Russian (legacy)
ru(typewriter-legacy) — Russian (typewriter, legacy)
ru(dos) — Russian (DOS)
ru(mac) — Russian (Macintosh)
ru(ab) — Abkhazian (Russia)
ru(bak) — Bashkirian
ru(cv) — Chuvash
ru(cv_latin) — Chuvash (Latin)
ru(xal) — Kalmyk
ru(kom) — Komi
ru(chm) — Mari
ru(os_legacy) — Ossetian (legacy)
ru(os_winkeys) — Ossetian (Windows)
ru(srp) — Serbian (Russia)
ru(tt) — Tatar
ru(udm) — Udmurt
ru(sah) — Yakut

Notice how ru is doing double duty as a home base for a whole bunch of languages, not just Russian. That's the vibe — one code, many friends 🫶

rs — Serbian
rs(alternatequotes) — Serbian (Cyrillic, with guillemets)
rs(yz) — Serbian (Cyrillic, ZE and ZHE swapped)
rs(latin) — Serbian (Latin)
rs(latinalternatequotes) — Serbian (Latin, with guillemets)
rs(latinunicode) — Serbian (Latin, Unicode)
rs(latinyz) — Serbian (Latin, QWERTY)
rs(latinunicodeyz) — Serbian (Latin, Unicode, QWERTY)
rs(rue) — Pannonian Rusyn

lk — Sinhala (phonetic)
lk(us) — Sinhala (US)
lk(tam_unicode) — Tamil (Sri Lanka, TamilNet '99)
lk(tam_TAB) — Tamil (Sri Lanka, TamilNet '99, TAB encoding)

Slovak said "we have options" and honestly? Respect 🎀

sk — Slovak
sk(bksl) — Slovak (extra backslash)
sk(qwerty) — Slovak (QWERTY)
sk(qwerty_bksl) — Slovak (QWERTY, extra backslash)

si — Slovenian
si(alternatequotes) — Slovenian (with guillemets)
si(us) — Slovenian (US)

es — Spanish
es(nodeadkeys) — Spanish (no dead keys)
es(deadtilde) — Spanish (dead tilde)
es(winkeys) — Spanish (Windows)
es(dvorak) — Spanish (Dvorak)
es(ast) — Asturian (Spain, with bottom-dot H and L)
es(cat) — Catalan (Spain, with middle-dot L)

Latin American Spanish gets its own whole block, we love an independent queen 👑

latam — Spanish (Latin American)
latam(nodeadkeys) — Spanish (Latin American, no dead keys)
latam(deadtilde) — Spanish (Latin American, dead tilde)
latam(dvorak) — Spanish (Latin American, Dvorak)
latam(colemak) — Spanish (Latin American, Colemak)

ke — Swahili (Kenya)
ke(kik) — Kikuyu

tz — Swahili (Tanzania)

Sweden really said "one of everything, please" 🌸

se — Swedish
se(nodeadkeys) — Swedish (no dead keys)
se(dvorak) — Swedish (Dvorak)
se(us_dvorak) — Swedish (Dvorak, intl.)
se(svdvorak) — Swedish (Svdvorak)
se(colemak) — Swedish (Colemak)
se(mac) — Swedish (Macintosh)
se(us) — Swedish (US)
se(swl) — Swedish Sign Language
se(smi) — Northern Saami (Sweden)
se(rus) — Russian (Sweden, phonetic)

tw — Taiwanese
tw(indigenous) — Taiwanese (indigenous)
tw(saisiyat) — Saisiyat (Taiwan)

tj — Tajik
tj(legacy) — Tajik (legacy)

th — Thai
th(tis) — Thai (TIS-820.2538)

And we're still going, obviously — the layout list is a journey, not a destination. Next chunk coming right up 💖

th(pat) — Thai, but the Pattachote flavor
th(mnc) — Thai, Manoonchai edition

bw — Tswana, periodt

tm — Turkmen
tm(alt) — Turkmen, the Alt-Q arrangement

tr — Turkish, the classic
tr(f) — Turkish (F)
tr(e) — Turkish (E)
tr(alt) — Turkish (Alt-Q)
tr(intl) — Turkish, international-style, with dead keys ✨
tr(ku) — Kurdish (Turkey, Latin Q)
tr(ku_f) — Kurdish (Turkey, F)
tr(ku_alt) — Kurdish (Turkey, Latin Alt-Q)

ua — Ukrainian, standard issue 💙💛
ua(phonetic) — Ukrainian (phonetic)
ua(typewriter) — Ukrainian (typewriter), very vintage-girl of it
ua(winkeys) — Ukrainian (Windows)
ua(winkeysenhanced) — Ukrainian (Windows Enhanced)
ua(macOS) — Ukrainian (macOS)
ua(legacy) — Ukrainian (legacy)
ua(homophonic) — Ukrainian (homophonic)
ua(crh) — Crimean Tatar (Turkish Q)
ua(crh_f) — Crimean Tatar (Turkish F)
ua(crh_alt) — Crimean Tatar (Turkish Alt-Q)

pk — Urdu (Pakistan)
pk(urd-crulp) — Urdu (Pakistan, CRULP)
pk(urd-nla) — Urdu (Pakistan, NLA)
pk(pak_urdu_phonetic) — Urdu (Pak Urdu Phonetic)
pk(ara) — Arabic (Pakistan)
pk(snd) — Sindhi (M.B. Sindhi)
pk(brahui) — Brahui (Pakistan)

uz — Uzbek
uz(latin) — Uzbek (Latin)

vn — Vietnamese
vn(us) — Vietnamese (US)
vn(fr) — Vietnamese (France) 🥖

sn — Wolof

custom — the user-defined custom Layout, aka you get to be the main character and build your own 🎀

fr fr bestie, that custom one is the one you pick when the built-in layouts just aren't giving what you need — and yeah, it's literally called custom, no cap 💅

✨ OPTIONS ✨

Okay bestie, this is the part where things get spicy — the options list 💅. Every one of these goes in as a value for XkbOptions (or the options field of your layout if you're doing the custom-layout thing), and they're how you tell your keyboard to do the little tricks you actually want. Not a summary of any of it, no skipping, we're going all the way through 🫶.

🎀 Switching to another layout

Your main character move: one key (or combo) and boom, you're in a whole different layout. Group switching, but make it fashion ✨.

grp:switch — Right Alt, but only while it's pressed 🎀
grp:lswitch — Left Alt, while pressed
grp:lwin_switch — Left Win, while pressed
grp:rwin_switch — Right Win, while pressed
grp:win_switch — Any Win key, while pressed
grp:menu_switch — Menu, while pressed — and Shift+Menu for the actual Menu
grp:caps_switch — Caps Lock, while pressed — with Alt+Caps Lock giving you the original Caps Lock action back 🙈
grp:rctrl_switch — Right Ctrl, while pressed
grp:toggle — Right Alt (toggle, bestie — not hold)
grp:lalt_toggle — Left Alt
grp:caps_toggle — Caps Lock
grp:shift_caps_toggle — Shift+Caps Lock
grp:caps_select — Caps Lock goes to the first layout; Shift+Caps Lock goes to the second layout
grp:win_menu_select — Left Win → first layout; Right Win/Menu → second layout
grp:ctrl_select — Left Ctrl → first layout; Right Ctrl → second layout
grp:alt_caps_toggle — Alt+Caps Lock
grp:shifts_toggle — Both Shifts together, iconic
grp:alts_toggle — Both Alts together
grp:alt_altgr_toggle — Both Alts together, and AltGr all by itself picks the third level
grp:ctrls_toggle — Both Ctrls together
grp:ctrl_shift_toggle — Ctrl+Shift
grp:lctrl_lshift_toggle — Left Ctrl+Left Shift
grp:rctrl_rshift_toggle — Right Ctrl+Right Shift
grp:ctrl_shift_toggle_bidir — Left Ctrl+Left Shift goes to the previous layout, Right Ctrl + Right Shift goes to the next one 🔥
grp:ctrl_alt_toggle — Alt+Ctrl
grp:lctrl_lalt_toggle — Left Alt+Left Ctrl
grp:rctrl_ralt_toggle — Right Alt+Right Ctrl
grp:ctrl_alt_toggle_bidir — Left Ctrl+Left Alt → previous layout, Right Ctrl + Right Alt → next layout
grp:alt_shift_toggle — Alt+Shift
grp:lalt_lshift_toggle — Left Alt+Left Shift
grp:ralt_rshift_toggle — Right Alt+Right Shift
grp:alt_shift_toggle_bidir — Left Alt+Left Shift → previous layout, Right Alt + Right Shift → next layout
grp:menu_toggle — Menu
grp:lwin_toggle — Left Win
grp:alt_space_toggle — Alt+Space
grp:win_space_toggle — Win+Space
grp:ctrl_space_toggle — Ctrl+Space
grp:rwin_toggle — Right Win
grp:lshift_toggle — Left Shift
grp:rshift_toggle — Right Shift
grp:lctrl_toggle — Left Ctrl
grp:rctrl_toggle — Right Ctrl
grp:sclk_toggle — Scroll Lock
grp:lctrl_lwin_rctrl_menu — Ctrl+Left Win → first layout; Ctrl+Menu → second layout
grp:lctrl_lwin_toggle — Left Ctrl+Left Win

🌸 Key to choose the 2nd level

Just the one legend here, and honestly? She ate 🍓

lv2:lsgt_switch — The "< >" key

🦋 Key to choose the 3rd level

This is the AltGr situation, basically. Third level, third vibe, third slay 👑

lv3:switch — Right Ctrl
lv3:menu_switch — Menu
lv3:win_switch — Any Win
lv3:lwin_switch — Left Win
lv3:rwin_switch — Right Win
lv3:alt_switch — Any Alt
lv3:lalt_switch — Left Alt
lv3:ralt_switch — Right Alt
lv3:ralt_switch_multikey — Right Alt, and Shift+Right Alt acts as Compose
lv3:ralt_alt — Right Alt never chooses the 3rd level, periodt
lv3:enter_switch — Enter on the keypad
lv3:caps_switch — Caps Lock
lv3:caps_switch_capslock_with_ctrl — Caps Lock, and Ctrl+Caps Lock gives you the original Caps Lock action
lv3:bksl_switch — Backslash
lv3:lsgt_switch — The "< >" key
lv3:caps_switch_latch — Caps Lock; acts as a onetime lock when it's pressed together with another 3rd-level chooser 🎀
lv3:bksl_switch_latch — Backslash; acts as a onetime lock when pressed together with another 3rd level chooser
lv3:lsgt_switch_latch — The "< >" key; acts as a onetime lock when pressed together with another 3rd level chooser

💜 Ctrl position

Where does Ctrl live in your heart? These options move it around, swap it, promote it, the whole glow-up 💅

ctrl:nocaps — Caps Lock as Ctrl
ctrl:lctrl_meta — Left Ctrl as Meta
ctrl:swapcaps — Swap Ctrl and Caps Lock
ctrl:grouptoggle_capscontrol — Caps Lock as Ctrl, and Left Control switches to another layout
ctrl:hyper_capscontrol — Caps Lock as Ctrl, Ctrl as Hyper
ctrl:ac_ctrl — To the left of "A"
ctrl:aa_ctrl — At the bottom left
ctrl:rctrl_ralt — Right Ctrl as Right Alt
ctrl:ralt_rctrl — Right Alt as Right Control
ctrl:menu_rctrl — Menu as Right Ctrl
ctrl:swap_lalt_lctl — Swap Left Alt with Left Ctrl
ctrl:swap_ralt_rctl — Swap Right Alt with Right Ctrl
ctrl:swap_lwin_lctl — Swap Left Win with Left Ctrl
ctrl:swap_rwin_rctl — Swap Right Win with Right Ctrl
ctrl:swap_lalt_lctl_lwin — Left Alt as Ctrl, Left Ctrl as Win, Left Win as Left Alt — the full three-way trade, obsessed 💀

💡 Use keyboard LED to show alternative layout

okay so your keyboard has lil lights on it and you can make them do double duty — press the LED to peep which layout group you're on ✨

grp_led:num — Num Lock
grp_led:caps — Caps Lock
grp_led:scroll — Scroll Lock

🎀 Use keyboard LED to indicate modifiers

same vibe, but the LED is telling you a modifier is currently held down 🫶

mod_led:compose — Compose

🔢 Layout of numeric keypad

the numpad is having a whole identity crisis and honestly? valid. pick your fave 💅

keypad:legacy — Legacy
keypad:oss — Unicode arrows and math operators
keypad:future — Unicode arrows and math operators on default level
keypad:legacy_wang — Legacy Wang 724
keypad:oss_wang — Wang 724 keypad with Unicode arrows and math operators
keypad:future_wang — Wang 724 keypad with Unicode arrows and math operators on default level
keypad:hex — Hexadecimal
keypad:atm — Phone and ATM style

🗑️ Numeric keypad Delete behavior

this one is about that one key on the numpad — you know the one — and what it actually spits out 😭

kpdl:dot — Legacy key with dot
kpdl:comma — Legacy key with comma
kpdl:dotoss — Four-level key with dot
kpdl:dotoss_latin9 — Four-level key with dot, Latin-9 only
kpdl:commaoss — Four-level key with comma
kpdl:momayyezoss — Four-level key with momayyez
kpdl:kposs — Four-level key with abstract separators
kpdl:semi — Semicolon on third level

👑 Caps Lock behavior

the main character of this entire page, no cap. Caps Lock can be literally anything you want — a Shift, an Esc, a Super, a whole menu button. go wild bestie 🔥

caps:internal — Caps Lock uses internal capitalization; Shift "pauses" Caps Lock
caps:internal_nocancel — Caps Lock uses internal capitalization; Shift does not affect Caps Lock
caps:shift — Caps Lock acts as Shift with locking; Shift "pauses" Caps Lock
caps:shift_nocancel — Caps Lock acts as Shift with locking; Shift does not affect Caps Lock
caps:capslock — Caps Lock toggles normal capitalization of alphabetic characters
caps:shiftlock — Caps Lock toggles Shift Lock (affects all keys)
caps:swapescape — Swap Esc and Caps Lock
caps:escape — Make Caps Lock an additional Esc
caps:escape_shifted_capslock — Make Caps Lock an additional Esc, but Shift + Caps Lock is the regular Caps Lock
caps:backspace — Make Caps Lock an additional Backspace
caps:return — Make Caps Lock an additional Return key
caps:super — Make Caps Lock an additional Super
caps:hyper — Make Caps Lock an additional Hyper
caps:menu — Make Caps Lock an additional Menu key
caps:numlock — Make Caps Lock an additional Num Lock
caps:ctrl_shifted_capslock — Make Caps Lock an additional Ctrl and Shift + Caps Lock the regular Caps Lock
caps:shift_shifted_capslock — Make Caps Lock an additional Shift and Shift + Caps Lock the regular Caps Lock
caps:ctrl_modifier — Make Caps Lock act as an additional Ctrl modifier, but keep identifying as Caps Lock
caps:digits_row — Caps Lock gives digits on the digits row (Azerty layouts)
caps:digits_row_independent_lock — Shift + Caps locks the digits on the digits row, Caps Lock alone behaves as usual (Azerty layouts)
caps:none — Caps Lock is disabled

🌸 Num Lock behavior

and finally, Num Lock gets to choose its own destiny too 🦋

numpad:numlock_only — NumLock enables digits; Shift does not interact with NumLock
numpad:pc — Shift and NumLock each enable digits; both together cancel (as in Classic XKB)
numpad:microsoft — NumLock enables digits; Shift cancels NumLock but never enables digits (as in Windows)
numpad:mac — Numeric keypad is independent of the NumLock state (as in macOS)
numpad:shift3 — NumLock enables digits; NumLock+Shift enables auxiliary symbols when available, digits otherwise

✨ Alt and Win behavior

okay so this is the group of options for everyone who's ever looked at their keyboard and gone "why is Alt like that" 😭 these remap what Alt / Win / Meta / Menu / Super actually do, bestie:

altwin:menu — gives the Menu key its standard behavior back
altwin:menu_win — Menu is mapped to Win
altwin:meta_alt — Alt and Meta both live on Alt
altwin:alt_win — Alt is mapped to Win, plus the usual Alt stays put
altwin:ctrl_win — Ctrl is mapped to Win, plus the usual Ctrl stays put
altwin:ctrl_rwin — Ctrl is mapped to Right Win, plus the usual Ctrl stays put
altwin:ctrl_alt_win — Ctrl is mapped to Alt, and Alt is mapped to Win
altwin:meta_win — Meta is mapped to Win
altwin:left_meta_win — Meta is mapped to Left Win
altwin:hyper_win — Hyper is mapped to Win
altwin:alt_super_win — Alt is mapped to Right Win, and Super is mapped to Menu
altwin:swap_lalt_lwin — Left Alt and Left Win swap places 🔄
altwin:swap_ralt_rwin — Right Alt and Right Win swap places 🔄
altwin:swap_alt_win — Alt swaps with Win
altwin:prtsc_rwin — Win is mapped to PrtSc, and the usual Win stays put

✨ Position of Compose key

where do you want your Compose key to live, babe? pick a spot 💅 the -altgr versions mean it's on the 3rd level of that key:

compose:ralt — Right Alt
compose:lwin — Left Win
compose:lwin-altgr — 3rd level of Left Win
compose:rwin — Right Win
compose:rwin-altgr — 3rd level of Right Win
compose:menu — Menu
compose:menu-altgr — 3rd level of Menu
compose:lctrl — Left Ctrl
compose:lctrl-altgr — 3rd level of Left Ctrl
compose:rctrl — Right Ctrl
compose:rctrl-altgr — 3rd level of Right Ctrl
compose:caps — Caps Lock
compose:caps-altgr — 3rd level of Caps Lock
compose:102 — the < > key
compose:102-altgr — 3rd level of the < > key
compose:paus — Pause
compose:ins — Insert
compose:prsc — PrtSc
compose:sclk — Scroll Lock

✨ Compatibility options

the nostalgia corner 🫶 these are the "make it work like the old days / like some other system" options — and bestie, read the fine print, because a bunch of them conflict with other modifiers and that's not a vibe:

hyper:mod2 — maps Hyper to Mod2 (conflict with NumLock 😬)
hyper:mod3 — maps Hyper to Mod3 (conflict with LevelFive 😬)
hyper:mod4 — maps Hyper to Mod4 (conflict with Super 😬)
hyper:mod5 — maps Hyper to Mod5 (conflict with LevelThree 😬)
meta:mod2 — maps Meta to Mod2 (conflict with NumLock 😬)
meta:mod3 — maps Meta to Mod3 (conflict with LevelFive 😬)
meta:mod4 — maps Meta to Mod4 (conflict with Super 😬)
meta:mod5 — maps Meta to Mod5 (conflict with LevelThree 😬)
scrolllock:mod3 — maps Scroll Lock to Mod3
srvrkeys:none — special keys (Ctrl+Alt+<key>) get handled in a server
apple:alupckeys — Apple Aluminium keyboards emulate Pause, PrtSc and Scroll Lock
apple:jp_oadg109a — Japanese Apple keyboards emulate the OADG109A backslash
apple:jp_pc106 — Japanese Apple keyboards emulate the PC106 backslash
shift:breaks_caps — Shift cancels Caps Lock
misc:typo — enables extra typographic characters ✨
misc:apl — enables APL overlay characters
shift:both_capslock — both Shifts together enable Caps Lock
shift:both_capslock_cancel — both Shifts together enable Caps Lock, and one Shift key disables it
shift:both_shiftlock — both Shifts together enable Shift Lock
keypad:pointerkeys — Shift + Num Lock enables PointerKeys
grab:break_actions — allows breaking grabs with keyboard actions

⚠️ okay real talk for a sec: grab:break_actions comes with a security risk warning attached. The manpage says it, i'm saying it, it's giving "do not casually ship this" 💀

grab:debug — allows grab and window tree logging

✨ Currency signs

getting that bag 💸 literally — here's where to stash your Euro and Rupee:

eurosign:e — Euro on E, third level
eurosign:E — Euro on E, fourth level
eurosign:2 — Euro on 2
eurosign:4 — Euro on 4
eurosign:5 — Euro on 5
rupeesign:4 — Rupee on 4

✨ Key to choose the 5th level

fifth level?? yes bestie, keyboards go deeper than you think 👑 these pick which key unlocks level 5, and the _lock ones also act as a one-time lock if you press them together with another 5th-level chooser:

lv5:caps_switch — Caps Lock chooses the 5th level
lv5:lsgt_switch — the < > key chooses the 5th level
lv5:ralt_switch — Right Alt chooses the 5th level
lv5:menu_switch — Menu chooses the 5th level
lv5:rctrl_switch — Right Ctrl chooses the 5th level
lv5:lsgt_switch_lock — the < > key chooses the 5th level and acts as a one-time lock if pressed with another 5th level chooser
lv5:ralt_switch_lock — Right Alt chooses the 5th level and acts as a one-time lock if pressed with another 5th level chooser
lv5:lwin_switch_lock — Left Win chooses the 5th level and acts as a one-time lock if pressed with another 5th level chooser
lv5:rwin_switch_lock — Right Win chooses the 5th level and acts as a one-time lock if pressed with another 5th level chooser

✨ Non-breaking space input

okay so this one is all about the humble space bar and its ✨fancy✨ cousins — non-breaking space, thin non-breaking space, zero-width non-joiner, zero-width joiner. pick your flavor at whatever level you want, bestie:

nbsp:none — the usual space at any level
nbsp:level2 — non-breaking space at the 2nd level
nbsp:level3 — non-breaking space at the 3rd level
nbsp:level3n — non-breaking space at the 3rd level, thin non-breaking space at the 4th level
nbsp:level4 — non-breaking space at the 4th level
nbsp:level4n — non-breaking space at the 4th level, thin non-breaking space at the 6th level
nbsp:level4nl — non-breaking space at the 4th level, thin non-breaking space at the 6th level (via Ctrl+Shift)
nbsp:zwnj2 — zero-width non-joiner at the 2nd level
nbsp:zwnj2zwj3 — zero-width non-joiner at the 2nd level, zero-width joiner at the 3rd level
nbsp:zwnj2zwj3nb4 — zero-width non-joiner at the 2nd level, zero-width joiner at the 3rd level, non-breaking space at the 4th level
nbsp:zwnj2nb3 — zero-width non-joiner at the 2nd level, non-breaking space at the 3rd level
nbsp:zwnj2nb3zwj4 — zero-width non-joiner at the 2nd level, non-breaking space at the 3rd level, zero-width joiner at the 4th level
nbsp:zwnj2nb3nnb4 — zero-width non-joiner at the 2nd level, non-breaking space at the 3rd level, thin non-breaking space at the 4th level
nbsp:zwnj3zwj4 — zero-width non-joiner at the 3rd level, zero-width joiner at the 4th level

that's a lot of invisible characters, i know 😭 but like. some languages literally need them. respect it 💅

🌸 Japanese keyboard options

japan:kana_lock — the Kana Lock key is locking
japan:nicola_f_bs — NICOLA-F style Backspace
japan:hztg_escape — make Zenkaku Hankaku an additional Esc

🎀 Korean Hangul/Hanja keys

korean:ralt_hangul — make right Alt a Hangul key
korean:rctrl_hangul — make right Ctrl a Hangul key
korean:ralt_hanja — make right Alt a Hanja key
korean:rctrl_hanja — make right Ctrl a Hanja key

🦋 Esperanto letters with superscripts

okay this is so niche and i'm obsessed — it puts those Esperanto letters with superscripts at the corresponding key depending on which layout you're running:

esperanto:qwerty — at the corresponding key in a QWERTY layout
esperanto:dvorak — at the corresponding key in a Dvorak layout
esperanto:colemak — at the corresponding key in a Colemak layout

💜 Old Solaris keycodes compatibility

solaris:sun_compat — Sun key compatibility

💀 Key sequence to kill the X server

terminate:ctrl_alt_bksp — Ctrl+Alt+Backspace

bestie, lowkey be careful with this one — this is the "oops i nuked my whole X session" combo. historic. iconic. dangerous. 🫶

⭐ Function keys

fkeys:basic_13-24 — use F13-F24 as usual function keys

🌈 Miscellaneous options

custom:types — use user-defined custom XKB types

🧚 FILES

here's where all the goods live, one per bullet, no cap:

/usr/share/xkeyboard-config-2/compat
/usr/share/xkeyboard-config-2/compiled
/usr/share/xkeyboard-config-2/geometry
/usr/share/xkeyboard-config-2/keycodes
/usr/share/xkeyboard-config-2/keymap
/usr/share/xkeyboard-config-2/rules
/usr/share/xkeyboard-config-2/semantics
/usr/share/xkeyboard-config-2/symbols
/usr/share/xkeyboard-config-2/types

🌟 SEE ALSO

setxkbmap(1) — the actual tool that makes all of this happen, go read it next fr fr

and that's the whole page, bestie, we made it to the end 🎉 go forth and have the most correct keyboard in the group chat 💖

ciao for now — this was X Version 11, xkeyboard-config 2.49, page XKEYBOARD-CONFIG(7) ✨ slay.

📦 where this page comes from

arch rolling: xkeyboard-config 2.49-1 · LicenseRef-xkeyboard-config
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms