> 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="/files/FZ3H5QgDSQJXHGuLUzty" alt=""><figcaption><p>This example uses the USB method</p></figcaption></figure>

<figure><img src="/files/UVPW7xNHYmJuSXx4Fsbd" 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="/files/rQTeF2wUg6kYBOa3zqLP" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/9g9RIibYiXvqdV2mzPJV" alt=""><figcaption></figcaption></figure>

For further information, follow the ZMK Documentation

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