📘
TaikoHub - Dactyl Manuform User Guide
Home
Version: 2022-07-01
Version: 2022-07-01
  • 1. Introduction (Version 2022-07-01)
  • 2. About Your Keyboard (Version 2022-07-01)
  • 3. Customizing Keyboard Layout for Windows and Mac with QMK (Version 2022-07-01)
  • 4. Customizing Keyboard Layout for Linux with QMK (Version 2022-07-01)
  • 5. Customizing Keyboard Layout with ZMK (Version 2022-07-01)
  • 6. Hot Swapping Keyswitches (Version 2022-07-01)
  • 7. Swapping Microcontrollers (Version 2022-07-01)
    • 7.1 Swapping Microcontrollers: Bluetooth (Version 2022-07-01)
  • 8. Tenting Your Keyboard (Version 2022-07-01)
  • 9. Troubleshooting (Version 2022-07-01)
    • 9.1 Troubleshooting: QMK Toolbox (Version 2022-07-01)
  • 10. Terminology (Version 2022-07-01)
  • 11. Changelog (Version 2022-07-01)
  • 12. Hardware Issues Tracking (Version 2022-07-01)
Powered by GitBook
On this page
  • 5.1 🌀ZMK Firmware
  • 5.2 📶Adding Bluetooth Functionality
  • 5.3 🖥️Repeat for the Other Piece of the Keyboard
  • 5.4 🎊Woot you're done!

5. Customizing Keyboard Layout with ZMK (Version 2022-07-01)

(10 min read)

Previous4. Customizing Keyboard Layout for Linux with QMK (Version 2022-07-01)Next6. Hot Swapping Keyswitches (Version 2022-07-01)

Last updated 9 months ago

5.1 🌀ZMK Firmware

Firmware: Firmware is software installed on microcontrollers to make your keyboard work.

ZMK Firmware: ZMK firmware is also known as just ZMK. It is a keyboard firmware similar to QMK, which is what your keyboard initially came with. ZMK and QMK are nearly identical for most users. The main difference being: If you want Bluetooth, use ZMK. If you want wired, use QMK.

Swap in nice!nanos before following this section. See 7.1 Swapping Microcontrollers: Bluetooth (Version 2022-07-01) before continuing below.

5.2 📶Adding Bluetooth Functionality

Step 1.A Add Bluetooth the Fast Way Using Default Configuration Files (5 minutes)

If you want your keyboard to have the same QWERTY layout as it initially came with, continue with this step. If you want to customize your keyboard layout, see Step 1.B instead.

Download the configuration file for the left and right piece of your keyboard. Then skip Step 1.B and continue to Step 2.

Step 1.B Add Bluetooth the Slow Way By Customizing Your Own Configuration Files (10+ minutes)

  1. Fork the repo.

  2. Clone it to your local machine.

  3. Edit config/dactyl_manuform_5x6.keymap.

  4. Push the edits to your remote repo.

  5. Navigate to GitHub Actions.

  6. Click firmware to download the firmware.zip file.

  7. Unzip the firmware.zip. Then continue to Step 2.

Step 2. Make sure the two sides of the keyboard are not connected to each other. Connect only the left piece of your keyboard to the computer.

Step 3. Click the reset switch twice. You should see NICE!NANO show up as a USB device. If you opened up the directory, you would see 3 files. Ignore them. Do not edit or delete them. Even after you flash the keyboard, there will only be these 3 files.

Step 4. Drag the dactyl_manuform_5x6_left-nice_nano_v2-zmk.uf file into the USB device directory. You may see the following prompt: Error while copying "dactyl_manuform_5x6_left-nice_nano_v2-zmk.uf2". This is not an actual error. The nice!nano uses the file you dragged to flash itself, then automatically ejects itself as a USB device.

5.3 🖥️Repeat for the Other Piece of the Keyboard

  • Repeat Section 5.2 Steps 2 to 4 for the right piece of the keyboard.

5.4 🎊Woot you're done!

  • Turn on the keyboard by clicking the on-off switch indicated by the green arrow in the figure below, then snap in the transparent plastic cover.

  • If the switch button height lowers, it means it's now turned on. If the switch button height rises, it means it's now turned off.

  • Since it's wireless, you no longer need to connect the USB cord or the audio cord. Turn on Bluetooth on your computer then pair with your keyboard.

  • Charge the keyboard battery by connecting a piece of the keyboard to your computer via USB.

Navigate to . See the Getting Started section in the README. The steps can be summarized as:

https://github.com/taikohub/zmk-config
0B
dactyl_manuform_5x6_left-nice_nano_v2-zmk.uf20:-42:335:76
ZMK Configuration File for the Left side of the TaikoHub Dactyl Manuform Keyboard in Size Large (Six Keyed Thumb Cluster)
0B
dactyl_manuform_5x6_right-nice_nano_v2-zmk.uf20:36:335:76
ZMK Configuration File for the Right side of the TaikoHub Dactyl Manuform Keyboard in Size Large (Six Keyed Thumb Cluster)
0B
dactyl_manuform_5x6_left-nice_nano_v2-zmk.uf20:-34:335:76
ZMK Configuration File for the Left side of the TaikoHub Dactyl Manuform Keyboard in Size Medium (Five Keyed Thumb Cluster)
307KB
dactyl_manuform_5x6_right-nice_nano_v2-zmk.uf2
ZMK Configuration File for the Right side of the TaikoHub Dactyl Manuform Keyboard in Size Medium (Five Keyed Thumb Cluster)
381KB
dactyl_manuform_5x6_left-nice_nano_v2-zmk.uf2
ZMK Configuration File for the Left side of the TaikoHub Dactyl Manuform Keyboard in Size Small (Three Keyed Thumb Cluster)
307KB
dactyl_manuform_5x6_right-nice_nano_v2-zmk.uf2
ZMK Configuration File for the Left side of the TaikoHub Dactyl Manuform Keyboard in Size Small (Three Keyed Thumb Cluster)
Figure 5.1 You should see NICE!NANO show up as a USB device.
Figure 5.2 This prompt is not an error: Error while copying "dactyl_manuform_5x6_left-nice_nano_v2-zmk.uf2" .
Figure 5.3 The green arrow points to the on/off switch.