SETXKBMAP(1)                General Commands Manual               SETXKBMAP(1)

<?><?><?> (NAME)
     setxkbmap - <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
     <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?> X

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
     setxkbmap [options] [layout [variant [option ...]]]

<?><?><?><?><?><?><?> (DESCRIPTION)
     <?><?><?><?><?> setxkbmap <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
     <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
     <?><?> <?><?> <?><?><?><?> X(7) <?><?><?><?><?> <?><?><?><?><?><?>.
     <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
     <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> xkeyboard-config(7)
     <?><?> <?><?><?><?><?><?>.

     <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>:

     -?, -help
             <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
             setxkbmap.

     -compat name
             <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?> (compatibility map) <?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?><?><?>.

     -config file
             <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> XKB <?><?>
             <?><?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
             <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

     -device deviceid
             <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> (device id)
             <?><?><?><?><?> <?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?> <?><?><?><?><?><?> Xorg(1)
             <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

     -display display
             <?><?><?><?><?><?><?><?> (display) <?><?> <?><?><?><?>
             <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
             <?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.

     -geometry name
             <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (geometry)
             <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
             <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?><?><?>.

     -I directory
             <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?><?><?> (rules) <?><?><?><?><?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?><?>.

     -keycodes name
             <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
             (keycodes) <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?> <?><?> <?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
             <?><?><?><?><?><?>.

     -keymap name
             <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (keymap)
             <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
             <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?><?><?>.

     -layout name
             <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
             <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?> <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?> -layout
             <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?><?>
             <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?><?> <?><?><?>.

     -model name
             <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
             <?><?><?><?><?><?>.  <?><?><?><?> <?><?> <?><?><?>
             <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
             <?><?><?><?><?> <?><?><?>.

     -option name
             <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
             <?><?><?><?> <?><?> <?><?><?><?> -option <?><?> <?><?><?><?>.
             <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> setxkbmap
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
             <?><?> <?><?><?><?><?> <?><?> <?><?>
             <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
             <?><?><?><?><?> <?><?><?> <?><?><?><?><?> (<?><?><?> <?><?><?><?>
             <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?> <?><?><?> <?><?><?>) <?><?><?><?><?>
             <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> -option
             <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?>.

     -print  <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
             <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> xkbcomp(1)
             <?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?>.
             <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?> (verbose) <?> <?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?> setxkbmap
             <?> xkbcomp(1) <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?> <?><?><?><?> (<?><?> <?><?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?>) <?><?><?><?><?><?><?> <?><?><?>.

     -query  <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
             <?><?><?><?><?> (variant) <?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?> <?><?><?>
             <?><?><?><?> <?><?><?><?><?><?>.

     -rules file
             <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
             <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?> <?><?><?><?><?>
             <?><?><?><?><?><?> <?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
             <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.

     -symbols name
             <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> (symbols)
             <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
             <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?><?><?>.

     -synch  <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> X <?><?><?><?><?>
             <?><?><?><?><?><?>.

     -types name
             <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (types) <?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?><?><?>.

     -variant name
             <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
             (variant) <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
             <?><?><?><?><?> -variant <?><?><?><?> <?><?> <?><?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
             <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
             <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
             <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?>
             <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
             -layout <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>.

     -v[erbose] [level]
             <?><?><?> <?><?><?><?><?><?> (verbosity) <?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
             <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?> <?><?> 0
             (<?><?><?><?><?><?> <?><?><?><?><?><?>) <?><?> 10
             (<?><?><?><?><?><?><?> <?><?><?><?><?><?>) <?><?><?>.
             <?><?><?><?><?><?><?>: 5.  <?><?> <?><?><?><?><?> <?><?>
             <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
             <?><?><?><?> -v <?><?> -verbose <?><?><?> <?><?> 1 <?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?>.

     -version
             <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
             <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (IMPLEMENTATION NOTES)
     <?><?> <?><?><?><?><?> <?><?><?><?> XKB <?><?> <?><?><?><?><?>
     <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?>
     <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> XKB <?><?>
     /usr/share/X11/xkb <?><?><?> <?><?><?><?><?><?> X(7)
     <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?>
     <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
     Xorg(1) <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
     <?><?><?><?><?> <?><?> -print <?><?> stdout(4) <?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (FILES)
     /usr/share/X11/xkb  <?><?><?><?> <?><?><?><?><?>
                         <?><?><?><?><?><?><?><?><?> XKB

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
     The setxkbmap utility exits 0 on success, and >0 if an error occurs.

<?><?><?><?><?><?><?> (EXAMPLES)
     <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> Caps Lock <?><?>
     <?><?><?><?><?> <?><?> Control <?><?> <?><?><?><?><?>:

           setxkbmap -option ctrl:nocaps

     <?><?><?><?><?> <?><?><?><?><?><?> <?><?> us <?>
     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
     <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
     <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> XKB <?><?><?><?>
     Xserver(1) <?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
     <?><?><?><?><?>:

           setxkbmap us -print | xkbcomp - $DISPLAY

     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> XKB:

           setxkbmap -option

<?><?><?><?><?> (DIAGNOSTICS)
     Cannot open display "default display"  <?><?><?><?> <?><?> <?><?>
     <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> X(7) <?><?><?><?>
     <?><?><?><?>.  <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
     <?><?><?><?><?> X(7) <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
     <?><?><?><?><?> <?><?><?><?><?> DISPLAY <?><?> <?><?><?><?><?>
     <?><?><?><?>.

     Running setxkbmap against an Xwayland server  <?><?><?> <?><?><?><?><?>
     <?><?> <?><?> <?><?><?><?> Xwayland(1) <?><?><?><?> <?><?><?><?><?><?>
     <?><?>.  <?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
     <?><?><?><?><?><?><?><?> <?><?><?><?> XKB <?><?><?><?><?><?><?><?><?><?>
     Wayland <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
     xkbcomp(1), X(7), xkeyboard-config(7)

<?><?><?><?><?><?><?> (HISTORY)
     setxkbmap <?><?><?><?><?><?> <?><?><?> <?><?> XFree86 3.2 <?><?><?><?>
     <?><?>.

Linux 6.12.107+deb13-amd64      March 29, 2025      Linux 6.12.107+deb13-amd64