Files
86Box-docs/hardware/keyboard.rst
2025-12-20 00:44:36 -03:00

145 lines
3.0 KiB
ReStructuredText

Keyboard
========
This page outlines keyboard behavior specific to different host operating systems, real keyboards and emulated machines.
Host systems
------------
Windows
^^^^^^^
* Not all multimedia function keys can be passed through to the emulated machine due to a Windows limitation.
* System-wide key remapping through the **Scancode Map** registry key (as performed by applications such as SharpKeys) is fully supported.
Linux
^^^^^
* The `xkbcommon <https://xkbcommon.org>`_ library is used to accurately map physical keys to the emulated keyboard on both X11 and Wayland. When compiling 86Box from source, make sure the development files for ``libxkbcommon`` and ``libxkbcommon-x11`` are installed, as this is an optional build component.
macOS
^^^^^
* Apple keyboards with **European or other ISO layouts** may have *the key below Esc* and *the key to the right of Left Shift* switch places in the emulated machine, due to a hardware quirk in many of those keyboards (both internal and external) and a limitation in the way macOS corrects it.
* The :kbd:`Num =` key is only usable in operating systems which recognize that key on Microsoft PS/2 multimedia keyboards.
* Mac special keys are mapped to their PC equivalents where possible:
.. list-table::
:header-rows: 1
:widths: 1 999
* - Emulated key
- Host key
* - Windows
- Command
* - Alt
- Option
* - Print Screen
- F13
* - Scroll Lock
- F14
* - Pause
- F15
* - Insert
- Command + Fn + Delete (MacBook and tenkeyless keyboards)
Command + Forward Delete (full size keyboards)
* - Num Lock
- Clear
Special keys
------------
Some keyboards provide additional function or otherwise special keys on top of the standard PC layout. Those keys are mapped to ones present on modern keyboards within reason.
Multimedia keys
^^^^^^^^^^^^^^^
Passthrough of Microsoft multimedia function keys such as :kbd:`Volume Up` and :kbd:`Play/Pause` can be disabled through the *Inhibit multimedia keys* option in the :ref:`Preferences window <usage/menubar:Tools>`.
Olivetti
^^^^^^^^
The Olivetti M series special keys are mapped as such:
.. list-table::
:header-rows: 1
:widths: 1 999
* - Emulated key
- Host key
* - CLEAR
- Page Up
* - BREAK
- Page Down
* - SCR PRT
- Print Screen
* - HELP
- Menu
* - 00
- Left Windows
* - F13
- Insert
* - F14
- Home
* - F15
- Del
* - F16
- End
* - F17
- Right Alt
* - F18
- Right Win
Toshiba
^^^^^^^
The Toshiba T1000 series function keys can be accessed by holding Right Alt or Right Ctrl:
.. list-table::
:header-rows: 1
* - Function
- Right Alt/Ctrl +
* - Show/hide numeric keypad overlay
- Num Lock
* - Change internal display font
- Right
* - Use internal display
- Home
* - Use external display
- End
* - Turbo mode on (T1200)
- Page Up
* - Turbo mode off (T1200)
- Page Down
* - Show/hide pop-up window (T1200)
- Print Screen