# 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](https://wiki.provenance-emu.com/using-provenance/controllers-and-controls) — Full controller guide
* [Supported Controllers](https://wiki.provenance-emu.com/using-provenance/controllers-and-controls/controllers) — Bluetooth and MFi controller list
* [Control Maps](https://wiki.provenance-emu.com/using-provenance/controllers-and-controls/control-maps) — Button mappings for all systems

***

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