> For the complete documentation index, see [llms.txt](https://guides-mechboards.gitbook.io/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides-mechboards.gitbook.io/guides/other-guides/using-zmk-studio.md).

# Using ZMK Studio

You can use ZMK Studio via the [desktop application](https://github.com/zmkfirmware/zmk/releases) or the [web app](https://zmk.studio/).

{% hint style="warning" %}
The desktop application allows you to change your keymap using Bluetooth. The web app **requires** you to connect one half of the keyboard via USB cable. 
{% endhint %}

{% hint style="danger" %}
Make sure to connect your keyboard to your device using Bluetooth
{% endhint %}

* Load ZMK Studio
* Select your device within ZMK

{% hint style="info" %}
Some devices require Studio Unlock to access ZMK Studio - you can find how on their respective Getting Started pages.
{% endhint %}

<figure><img src="https://456586235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6bjiReLol1HqmhjbjtT5%2Fuploads%2FBtzI01Bu8ZZDz5MuhOwB%2Fimage.png?alt=media&amp;token=fc196d03-5a86-40a4-ac3e-713b84a0823b" alt=""><figcaption><p>This example uses the USB method</p></figcaption></figure>

<figure><img src="https://456586235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6bjiReLol1HqmhjbjtT5%2Fuploads%2F56cn9bSTTGgqcbyNwog7%2Fimage.png?alt=media&amp;token=10034fcd-faf7-4fca-b453-11b4ce5dbbaf" alt=""><figcaption><p>Here is the Studio Unlock warning. you can find how to unlock your device on their respective Getting Started pages</p></figcaption></figure>

Once unlocked you'll be greeted with the overview screen, showing the keymap layout and on the left column the different layers.&#x20;

<figure><img src="https://456586235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6bjiReLol1HqmhjbjtT5%2Fuploads%2FvAwqNuPw1pntRBz1h6Gk%2Fimage.png?alt=media&amp;token=76a56318-32e3-4a29-aa07-7e065119c942" alt=""><figcaption></figcaption></figure>

Clicking a key brings up the editor area, where you can reassign your key.&#x20;

<figure><img src="https://456586235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6bjiReLol1HqmhjbjtT5%2Fuploads%2FImOvwlg28KpYvdRq4dLf%2Fimage.png?alt=media&amp;token=7fca7c58-aa28-412f-b4fe-1802e7e8a28f" alt=""><figcaption></figcaption></figure>

For further information, follow the ZMK Documentation

{% embed url="<https://zmk.dev/docs>" %}