# 1. Introduction

## 1.1 Welcome👋

Thank you for purchasing a [TaikoHub dactyl manuform keyboard](https://taikohub.com/). This user guide will be continuously updated. If you have any questions, please email me anytime at <david@taikohub.com>. I will try to get back to you as soon as I can.

Please make sure you selected the correct keyboard version on the left. Version refers to the date of shipment. For example, Version 2021-06-24 refers to any keyboard shipped from 2021-06-24 to 2021-09-11. Version 2024-05-01, the most current version, refers to any keyboards shipped after 2025-05-01.

If you are confused about anything or have suggestions on how to improve the documentation, please share it in the GitHub discussions page [here](https://github.com/taikohub/dactyl-manuform-documentation/discussions/categories/general).

## 1.2 Getting started

1. Your keyboard should work without any configurations.&#x20;
2. Connect the audio cord to each side of the keyboard.
3. Connect the USB cord to the **left side** of the keyboard.
4. Your keyboard comes pre-flashed with the default keyboard layout seen in sections 1.1 to 1.3 below.
5. The rest of the documentation discusses how to customize the keyboard. Please read it before customizing the keyboard!

{% hint style="success" %}
Please read the relevant section in the documentation before you customize the keyboard.
{% endhint %}

{% hint style="warning" %}
Avoid disconnecting and connecting the audio cord while it is connected to a power source.
{% endhint %}

## 1.3 Keyboard layout

{% hint style="info" %}
The MO(1) and MO(2) keys seen in the keyboard layouts in section 1.2 below are also known as LOWER and RAISE keys. These function similar to a SHIFT key on a regular keyboard.
{% endhint %}

### 1.3.1 Default keyboard layout for size large (6 keyed thumb cluster)

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/bLfmVWwH4GACPMPHrqSv/Screenshot%20from%202021-06-24%2021-58-42.png" alt="taikohub-dactyl-manuform-keyboard-with-six-keyed-thumb-cluster-keyboard-layout-base-layer"><figcaption><p>Layer 0 - Default keymap.</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/hRJS0PRUEDDGWkZQOsUK/Screenshot%20from%202021-06-24%2021-59-05.png" alt="taikohub-dactyl-manuform-keyboard-with-six-keyed-thumb-cluster-keyboard-layout-lower-layer"><figcaption><p>Layer 1 - The keymap when you hold MO(1).</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/wCVSHQ3J8P1REp3FtaLb/Screenshot%20from%202021-06-24%2021-59-24.png" alt="taikohub-dactyl-manuform-keyboard-with-six-keyed-thumb-cluster-keyboard-layout-raised-layer"><figcaption><p>Layer 2 - The keymap when you hold MO(2).</p></figcaption></figure>

### 1.3.2 Default keyboard layout for size medium (5 keyed thumb cluster)

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/FYIOjDVqdM8cFfc5RkgI/five_layer_0.jpg" alt="taikohub-dactyl-manuform-keyboard-with-five-keyed-thumb-cluster-keyboard-layout-base-layer"><figcaption><p>Layer 0 - Default keymap. If your 5 keyed thumb cluster keyboard was shipped July 12, 2022 or later, it will have the keyboard layout shown above. For keyboards shipped prior to July 12, 2022, please see section 9. CHANGELOG.</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/p4i8Jw40vBO09gpMKanY/five_layer_1.png" alt="taikohub-dactyl-manuform-keyboard-with-five-keyed-thumb-cluster-keyboard-layout-lower-layer"><figcaption><p>Layer 1 - The keymap when you hold MO(1).</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/zOKbw5DtDzWv1DPjtA3T/five_layer_2.png" alt="taikohub-dactyl-manuform-keyboard-with-five-keyed-thumb-cluster-keyboard-layout-raised-layer"><figcaption><p>Layer 2 - The keymap when you hold MO(2).</p></figcaption></figure>

### 1.3.3 Default keyboard layout for size small (3 keyed thumb cluster)

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/V6tTyMcX0mDf7fWqCEtg/layer0.png" alt="taikohub-dactyl-manuform-keyboard-with-three-keyed-thumb-cluster-keyboard-layout-base-layer"><figcaption><p>Layer 0 - Default keymap.</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/zUof1rCaJrSnfScMabQU/layer1.png" alt="taikohub-dactyl-manuform-keyboard-with-three-keyed-thumb-cluster-keyboard-layout-lower-layer"><figcaption><p>Layer 1 - The keymap when you hold MO(1).</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/KxKAW6ysXyLp6YklgEcR/layer2.png" alt="taikohub-dactyl-manuform-keyboard-with-three-keyed-thumb-cluster-keyboard-layout-raised-layer"><figcaption><p>Layer 2 - The keymap when you hold MO(2).</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.taikohub.com/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.