> For the complete documentation index, see [llms.txt](https://wiki.provenance-emu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.provenance-emu.com/using-provenance/controllers-and-controls/smartkeyboard.md).

# Smart Keyboard Mapping

Provenance supports playing games with a **Smart Keyboard** (iPad), **Magic Keyboard**, or any **external Bluetooth/USB keyboard**. This is useful when you don't have a controller available.

{% hint style="info" %}
Keyboard mappings are currently hard-coded and cannot be customized. Custom key remapping is planned for a future update.
{% endhint %}

***

## Button Mappings

### D-Pad

| Direction | Key           |
| --------- | ------------- |
| Up        | `Up Arrow`    |
| Down      | `Down Arrow`  |
| Left      | `Left Arrow`  |
| Right     | `Right Arrow` |

### Analog Sticks

| Left Stick | Key |   | Right Stick | Key |
| ---------- | --- | - | ----------- | --- |
| Up         | `W` |   | Up          | `=` |
| Down       | `S` |   | Down        | `-` |
| Left       | `A` |   | Left        | `[` |
| Right      | `D` |   | Right       | `]` |

### Face Buttons

| Button | Key        |
| ------ | ---------- |
| A      | `Spacebar` |
| B      | `F`        |
| X      | `Q`        |
| Y      | `E`        |

### Shoulder Buttons / Triggers

| Button | Key          |
| ------ | ------------ |
| L1     | `Tab`        |
| L2     | `Left Shift` |
| R1     | `R`          |
| R2     | `V`          |

### System Buttons

| Button       | Key         |
| ------------ | ----------- |
| Menu (Pause) | `~` (tilde) |
| Options      | `1`         |

***

## Tips

* **iPad Smart Keyboard / Magic Keyboard** works seamlessly — just connect and play
* **Bluetooth keyboards** pair in Settings → Bluetooth like any other accessory
* Keyboard input works alongside on-screen controls — both can be active simultaneously
* For the best experience with keyboard, use **landscape orientation** so the game fills more of the screen

***

## See Also

* [Controllers & Controls](/using-provenance/controllers-and-controls.md) — Full controller guide
* [Supported Controllers](/using-provenance/controllers-and-controls/controllers.md) — Bluetooth and MFi controller list
* [Control Maps](/using-provenance/controllers-and-controls/control-maps.md) — Button mappings for all systems

***

{% hint style="info" %}
Need help? Ask on [Discord](https://discord.gg/provenance).
{% endhint %}