Keyboard and shortcuts
Remap Caps Lock, Alt and Super or other keys on a physical keyboard, give Linux the Meta key on Samsung DeX, and make key combinations that open apps, Layouts and commands.
A physical keyboard, whether Bluetooth, USB or a keyboard cover, works in Linux with no setup. Keyboard in Settings changes what its keys send and adds shortcuts of your own.
Breadstick Pro. Anyone can open the Keyboard settings and see what is there; changing them opens the Pro screen.
Where the settings apply
The settings are for a physical keyboard, in Linux windows: the Linux desktop in Desktop mode, and every floating window in Floating mode. In the Terminal only the Caps Lock choice applies; the rest do not.
The on-screen keyboard is never remapped, and neither are keys Breadstick sends by itself, such as the three-finger swipe between desks or the Ctrl of a pinch to zoom.
Android and Samsung DeX keep some combinations for themselves, such as Alt+Tab. Those never reach Linux, remapped or not. The Alt you hold for one no longer opens the menu of the Linux app underneath, either, when you switch away with Alt+Tab.
Alt+F4
In Floating mode, Alt+F4 closes the floating window in front, the same way as its close button: the program is asked to close, so it can ask about unsaved work first. See Closing a floating window. On the Linux desktop, Alt+F4 is the desktop's own key and closes the Linux window in front. Alt+F4 works without Pro.
Caps Lock
Caps Lock can stay Caps Lock, or become Ctrl or Escape. As Ctrl it works like any Ctrl key: hold it with another key. If Caps Lock was on when you changed it, the next key you press turns it off first, so you are not left typing capitals with no key to stop them.
Swap Alt and Super
Swap Alt and Super puts Super beside the space bar, where a Mac keyboard has Command. It swaps the keys on both sides of the keyboard.
The Meta key on Samsung DeX
DeX keeps the Meta key (the Windows key on many keyboards) and its shortcuts for itself. Meta key in Linux gives it to Linux instead, as Super, while a Linux window is in front. The switch appears on Samsung devices that allow it.
Remapping a key
Remap a key, then press the key to change on the physical keyboard, and choose what it sends: Ctrl, Alt, AltGr, Super, Shift, Escape, Caps Lock, Menu, Delete, Insert, Home, End, Page Up, Page Down, Print Screen, or Nothing.
Any key can be remapped to one of those. Nothing turns a key off, useful for one you keep pressing by accident. Each remapped key is listed under Remapped keys, with Remove beside it.
Shortcuts
A shortcut is a key combination that opens something instead of reaching Linux. Under Shortcuts, tap Add, press the combination on the physical keyboard, and choose what it does:
- Open an app: any app in the Apps drawer
- Open a layout: one of your saved Layouts
- Run a command: it runs in a terminal window, which stays open to show the result
A shortcut needs Ctrl, Alt or Super in it, so it cannot take over a key you type with. Keys are counted as Linux sees them: with Caps Lock set to Ctrl, Caps Lock plus a letter counts as a Ctrl combination. Setting a combination that is already in use replaces the old shortcut, and the dialog says so before you save.
Shortcuts work while a Linux window has the keyboard, on the desktop or in a floating window. Layouts open only in Floating mode, so a Layout's shortcut pressed on the Linux desktop shows a message asking you to stop the Desktop session first.
If Pro ends
Your settings stay listed, and the keyboard goes back to sending what its keys say until Pro returns. Then they apply again as they were.
When keys do not arrive at all
If a physical keyboard types nothing in Linux apps, check which on-screen keyboard is active. See Troubleshooting.