Keyboard Layouts and Keyboard Shortcuts
LuxOS has two keyboard apps: Keyboard Layouts (luxos-keyboard), which sets the layouts and
how to switch between them for the whole system, and Keyboard Shortcuts (luxos-shortcuts),
which shows and edits the global shortcuts. In shortcuts, Super (the Windows key) plays the role
of the macOS Cmd key.
Keyboard Layouts (luxos-keyboard)
Open it from Launchpad ("Keyboard Layouts"), by clicking the keyboard flag in the top bar and
choosing keyboard settings, or by running luxos-keyboard. (In LuxOS, xfce4-keyboard-settings
with no arguments also opens this app.)
- Layouts: up to 4 (an XKB limit). The first one is the default. Add Layout… lists common layouts first (English (US), Czech, Czech (QWERTY), Slovak, German, English (UK), French, Spanish, Italian, Polish, Hungarian, Ukrainian, Portuguese, Portuguese (Brazil), Swedish), and you can search all XKB layouts and variants. Each layout can be moved up, moved down or removed.
- Switching: "Switch layouts with" one of these:
| Choice | XKB option |
|---|---|
| Both Shift keys (default) | grp:shifts_toggle |
| Alt + Shift | grp:alt_shift_toggle |
| Ctrl + Shift | grp:ctrl_shift_toggle |
| Caps Lock | grp:caps_toggle |
| Menu key | grp:menu_toggle |
| Only by clicking the flag in the menu bar | (none) |
Super+Space is not offered, because it opens Search. "Both Shift keys" means pressing left and
right Shift together; it does not clash with shortcuts such as Alt+Shift+Tab. Older LuxOS
installs that still had the previous default (only grp:alt_shift_toggle) are switched to
grp:shifts_toggle by the luxos-desktop package update (takes effect at the next login); a
layout switch chosen by the user is never changed.
- A test field ("Type here to test your keyboard"). Changes are tried right away in the running
session (setxkbmap). If you close the window without applying them, the old layout comes back.
- Apply to All Users and the Login Screen saves through localectl set-x11-keymap
(systemd-localed). This asks for administrator authentication (polkit). It writes
/etc/X11/xorg.conf.d/00-keyboard.conf, and localed derives the console keymap in
/etc/vconsole.conf from it.
- More Keyboard Settings… opens the original Xfce dialog (/usr/bin/xfce4-keyboard-settings),
which has key repeat and similar settings.
How layouts are applied
By default every user follows the system layouts: the xfconf channel keyboard-layout has
/Default/XkbDisable = true (default file in /etc/xdg/luxos). If a user turned on their own
layouts in the Xfce keyboard settings (XkbDisable = false), those override the system ones. The
app then shows "Your account uses its own keyboard layouts from Xfce settings", and clicking Apply
switches the account back to the system layouts.
The installer (text and graphical) writes the same file format, so layouts chosen during installation also show up here.
Troubleshooting layouts
- Wrong layout at login or in the console: apply it again in Keyboard Layouts. That is the only place that sets it for the login screen and the console.
- The layout changes only in one account: that account has its own Xfce layouts. Click Apply in
Keyboard Layouts, or check with
xfconf-query -c keyboard-layout -p /Default/XkbDisable(should betrue). - Cannot switch layouts: check the "Switch layouts with" choice (default: both Shift keys pressed together). With "Only by clicking the flag", there is no key combination.
- Check the current settings:
localectl status(system),setxkbmap -query(session).
Keyboard Shortcuts (luxos-shortcuts)
Open it with luxos-shortcuts, from Welcome (Shortcuts) or from the last page of the LuxOS Tour.
Shortcuts are stored in the xfconf channel xfce4-keyboard-shortcuts. Commands are under
/commands/custom/<shortcut> (run by xfsettingsd), and window actions are under
/xfwm4/custom/<shortcut> (xfwm4). Changes apply at once.
Sections: Windows, Apps & System, Screenshots, Custom Shortcuts, and Other Xfce Shortcuts (stock Xfce shortcuts that LuxOS keeps).
Change, turn off, add and reset
- Change: click a shortcut, then press the new combination ("Press the new shortcut for …"). Esc cancels and Backspace turns the shortcut off. A shortcut must use at least one of Ctrl, Alt or Super. The exceptions are single function keys (F1–F39), multimedia/XF86 keys, Print, Pause, Scroll Lock and Menu.
- Conflicts: if the combination is already used, the app says "“X” is already used by “Y”" and offers Replace. Replacing frees the key from the other action.
- Turn off: a system (default) shortcut is turned off by setting an empty command. It cannot be deleted, because resetting the xfconf property would bring back the system value. A user-added shortcut is deleted.
- Restore Default (per action) or Restore All Defaults…. Custom shortcuts are kept unless a default shortcut needs their keys.
- Add Shortcut…: a name (e.g. "Open my notes"), a command (or Choose App…), and Record
Shortcut…. The names of custom shortcuts are stored in
~/.config/luxos/shortcuts.json. xfconf itself only stores the command. - The layout switching shortcut is shown here but is set in Keyboard Layouts ("Set together with the keyboard layouts").
- Super key alone opens Launchpad (under Apps & System, on by default): a switch for tapping Super on its own (see "Other keys" below). Super+A keeps working either way.
From a script, use xfconf-query -c xfce4-keyboard-shortcuts -l -v to list shortcuts. For example,
xfconf-query -c xfce4-keyboard-shortcuts -p '/commands/custom/<Super>k' -n -t string -s 'firefox'
adds one. Run this only inside the user's own session.
Default shortcuts
These are the LuxOS defaults from /etc/xdg/luxos/xfce4/xfconf/xfce-perchannel-xml/xfce4-keyboard-shortcuts.xml.
When the package is built, the stock Xfce defaults are merged in, so other Xfce shortcuts may exist
as well. They appear under "Other Xfce Shortcuts".
Apps and system
| Shortcut | Action | Command |
|---|---|---|
| Super+Space | Search | luxos-search |
| Super (tap alone) | Launchpad (open/close) | luxos-launchpad (via luxos-menubar) |
| Super+A | Launchpad | luxos-launchpad |
| Launch A key (XF86LaunchA) | Launchpad | luxos-launchpad |
| Super+E | Files | thunar |
| Super+T | Terminal | luxos-terminal |
| Ctrl+Alt+T | Terminal | luxos-terminal |
| Super+, (comma) | Settings | xfce4-settings-manager |
| Super+. (period) | Emoji & Symbols | luxos-emoji |
| Ctrl+Super+Space | Emoji & Symbols (macOS habit) | luxos-emoji |
| Super+L | Lock screen | xflock4 |
| Ctrl+Super+Q | Lock screen | xflock4 |
| Super+Alt+Esc | System Monitor (force quit) | luxos-monitor |
| Ctrl+Shift+Esc | System Monitor (force quit) | luxos-monitor |
| Super+P | Displays quick menu | luxos-displays menu |
| Display key (XF86Display) | Displays quick menu | luxos-displays menu |
| Calculator key (XF86Calculator) | Calculator | luxos-calculator |
| Ctrl+Alt+Delete | Log out or shut down | xfce4-session-logout |
| Power key (XF86PowerOff) | Log out or shut down | xfce4-session-logout |
Screenshots
| Shortcut | Action | Command |
|---|---|---|
| Super+Shift+3 | Screenshot of the whole screen | luxos-screenshot --screen |
| Super+Shift+4 | Screenshot of a region (Space = window) | luxos-screenshot --portion |
| Super+Shift+5 | Screenshot tool (floating bar) | luxos-screenshot |
| Screenshot tool | luxos-screenshot |
|
| Shift+Print | Screenshot of a region | luxos-screenshot --portion |
Windows (xfwm4)
| Shortcut | Action |
|---|---|
| Super+Q, Alt+F4 | Close window |
| Super+M, Super+H, Super+Down | Minimize window |
| Super+Tab, Alt+Tab | Switch windows |
| Super+Shift+Tab, Alt+Shift+Tab | Switch windows backwards |
| Alt+` (grave) | Switch windows of the current app (Alt+Tab previews, only windows with the same WM_CLASS) |
| Alt+Shift+` | Switch windows of the current app backwards |
| Super+` (grave) | Next window of the same app, without previews |
| Super+Up | Maximize window |
| Super+Left / Super+Right | Tile window left / right (half screen) |
| Ctrl+Super+F, F11 | Full screen |
| Super+D | Show desktop |
| Ctrl+Super+Left / Ctrl+Super+Right | Previous / next workspace (2 workspaces by default) |
| Ctrl+Super+1 / Ctrl+Super+2 | Go to workspace 1 / 2 |
Esc and the arrow keys are bound to xfwm4's internal cancel and movement keys, which are used while moving or resizing windows.
The key is the key below Esc (above Tab) in every layout: xfwm4 from [luxos] (packages/xfwm4)
binds shortcuts withgraveto the physical XKB key<TLDE>. On the Czech layout this key types
";" and "" is only on AltGr of other keys, so stock xfwm4 resolved <Alt>grave to the H key. The
actions are cycle_app_windows_key and cycle_reverse_app_windows_key (new in the LuxOS xfwm4);
older profiles get the two shortcuts once at login (luxos-session, marker
~/.config/luxos/app-windows-shortcuts), only when the keys are still free.
Group windows by app in Alt+Tab (Keyboard Shortcuts › Windows, off by default; xfconf
xfwm4 /general/cycle_group_apps): Alt+Tab shows every app once, with its most recently used
window. While holding Alt, Down or shows the windows of the selected app ( also moves to its
next window), Up goes back to the list of apps; releasing Alt activates the selected window.
Other keys
- Volume and media keys are handled by the sound plugin in the top bar.
- Layout switching: both Shift keys together by default (Keyboard Layouts).
- Tapping Super alone (press and release within 0.4 s, no other key or mouse button in
between) opens Launchpad, like the Start key on Windows; tapping it again closes it. Super+key
shortcuts never trigger it. It is detected by
luxos-menubarfrom passive XInput2 raw key events (no key grabs) and does nothing while another program holds the keyboard (locked screen, screensaver, open menu, recording a shortcut). Turn it off in Keyboard Shortcuts ("Super key alone opens Launchpad"); this creates~/.config/luxos/super-launchpad-off, whichluxos-menubarchecks every 5 seconds. - In Launchpad and Search, Ctrl+Enter sends the typed text to LuxAI.
- In the Calculator, Ctrl+1 and Ctrl+2 switch between the basic and scientific modes.