{{Header}} __FORCETOC__
{{title|title=
Keyboard Layout
}}
{{#seo:
|description=How to change the Keyboard Layout in {{project_name_long}}.
|image=Keyboardlayout1282268640.jpg
}}
<div class="mininav">
* [[Language]]
* [[Keyboard Layout]]
</div>
[[File:Keyboardlayout1282268640.jpg|thumb]]
{{intro|
This wiki page provides information on keyboard layouts and how to configure them in {{project_name_short}}.
}}
= {{non_q_project_name_short}} =
== Desktop Environment ==
=== Version 17 ===
Kicksecure 17 only.

{| class="wikitable"
|+ ''Desktop Keyboard Layout Change''

|-
! '''Platform'''
! '''Steps'''
|-

! Xfce
|
To permanently change the keyboard layout, apply the following steps.

* <code>Applications</code> &rarr; <code>Settings</code> &rarr; <code>Keyboard</code> &rarr; <code>Layout</code> &rarr; <code>disable "use system defaults"</code> &rarr; <code>add your layout at the bottom</code> &rarr; <code>remove the old layout</code> &rarr; <code>close</code>
|-

! Graphical Terminal Emulator (X11)
| Temporary until reboot. <ref>
[https://manpages.debian.org/setxkbmap setxkbmap Man Page]
</ref>

{{CodeSelect|code=
setxkbmap de
}}

<u>Note:</u> To set the keyboard to your preferred language, run this command to list all possible layouts.

{{CodeSelect|code=
localectl list-x11-keymap-layouts
}}
|-

|}

=== Version 18 ===
Kicksecure 18 and above.

Per-user configuration. (Not system-wide configuration.)

{| class="wikitable"
|+ ''Desktop Keyboard Layout Change''

|-
! '''Platform'''
! '''Steps'''
|-

! LXQt + labwc Wayland compositor - TUI
|
<u>{{tui}}</u>

Interactive:

{{CodeSelect|code=
set-labwc-keymap --interactive
}}
|-

! LXQt + labwc Wayland compositor - CLI
|
<u>{{cli}}</u>

View available keymaps.

{{CodeSelect|code=
localectl list-x11-keymap-layouts
}}

<u>Syntax:</u>

<pre>
set-labwc-keymap --persist keymap
</pre>

<u>Example:</u>

<u>Note:</u> Replace <code>de</code> with the actual keymap to use.

{{CodeSelect|code=
set-labwc-keymap --persist de
}}

<u>Manually:</u> See footnote. <ref>
<code>labwc</code> uses the <code>XKB_DEFAULT_LAYOUT</code> environment variable, as documented at https://labwc.github.io/getting-started.html.

To permanently change the keyboard layout, apply the following steps.

* Open a terminal &rarr; Run <code>mkdir -p ~/.config/labwc</code> &rarr; Run <code>nano ~/.config/labwc/environment</code> &rarr; Type <code>XKB_DEFAULT_LAYOUT=zz</code>, replacing <code>zz</code> with the code for your keyboard layout &rarr; Type <code>Ctrl+S</code> to save, then <code>Ctrl+X</code> to exit &rarr; Run <code>labwc --reconfigure</code> to load new settings.

<u>Note:</u> To set the keyboard to your preferred language, run this command to list all possible layouts.
</ref>
|-

! scope="row" | Other Wayland compositors
| Differs depending on the Wayland compositor in use. Usually can be set using DE-specific tools, may require editing a configuration file and then restarting the compositor to make changes take effect.
|-

|}

== Virtual Terminal ==
{{Anchor|Terminal}}

To change the <u>keyboard layout</u>. <ref>
French keyboards:
<br />
Perhaps an upstream bug.
<br />
( https://web.archive.org/web/20160519163403/https://free.nchc.org.tw/clonezilla-live/stable/Known-issues-Clonezilla-live.txt )
<br />
If you are using French Keymap, remember to use "Select keymap from full list":
<br />
1. Select keymap from full list
<br />
2. pc / azerty / French / Same as X11 (latin 9) /Standard
</ref>

<u>Note:</u> Changes keyboard layout for virtual terminals only. This does not effect the graphical environment.

Whonix 17, 18:

{{CodeSelect|code=
sudo dpkg-reconfigure keyboard-configuration
}}

Make the reconfigured keyboard-configuration change take effect.

{{CodeSelect|code=
sudo setupcon
}}

<ref>
Alternative <code>/etc/default/keyboard</code> method: <br />

{{Open with root rights|filename=
/etc/default/keyboard
}}
</ref> <ref>
Alternative <code>loadkeys</code> method: <br />

Temporary until reboot.

{{CodeSelect|code=
sudo loadkeys de
}}
</ref>

Whonix 18 and above:

{{CodeSelect|code=
sudo set-console-keymap
}}

== Simple ==
Whonix 18 and above:

<code>set-system-keymap</code> sets both keyboard layouts for,

* 1) {{cli}}, <u>and</u>
* 2) {{gui}}.

With 1 command only. It can either be started from

* A) [[System Maintenance Panel]], <u>or</u>
* B) from the command line.

{{tui}}:

{{CodeSelect|code=
sudo set-system-keymap --interactive
}}

CLI:

{{CodeSelect|code=
sudo set-system-keymap
}}

If installing {{project_name_long}} using its [[ISO]], {{project_name_long}}'s Calamares based installer) uses <code>set-system-keymap</code> internally to configure the keyboard layout.

= {{q_project_name_short}} =

To correctly apply changes system-wide via <code>dom0</code>: <ref>
The Qubes bug reporting [https://github.com/QubesOS/qubes-issues/issues/1396 the change does not propagate to other VMs] has now been resolved.
</ref>

* <code>System Tools</code> &rarr; <code>Keyboard</code> &rarr; <code>Layout</code>

Alternatively, [https://github.com/Qubes-Community/Contents/blob/master/docs/customization/language-localization.md language localization input] can be configured on a per VM basis.

If problems are encountered, see: [https://www.qubes-os.org/faq/#my-keyboard-layout-settings-are-not-behaving-correctly-what-should-i-do My keyboard layout settings are not behaving correctly. What should I do?] in the Qubes FAQ.

= See Also =
* [[Language|Change the System or Firefox Language]]

= Footnotes =
{{reflist|close=1}}

{{Footer}}

[[Category:Documentation]]