1. Introduction
Thank you for choosing the ZUOYI GMK21 Wireless Mechanical Keyboard KIT. This 21-key tri-mode keyboard offers versatile connectivity options (Wired, Bluetooth 5.0, and 2.4G Wireless) and features a hot-swappable design, allowing for easy customization of switches. This manual provides detailed instructions for setup, operation, maintenance, and troubleshooting to ensure an optimal user experience.
2. Specifications
| Feature | Description |
|---|---|
| Brand | ZUOYI |
| Model | GMK21 |
| Connectivity | Tri-Mode (Wired USB, Bluetooth 5.0, 2.4G Wireless) |
| Key Count | 21 Keys (Mini Keyboard Standard) |
| Operation Style | Mechanical |
| Hot-Swap | Yes (Supports 3-pin and 5-pin switches) |
| Backlight | RGB (MULTICOLOR, adjustable) |
| Customization | QMK/VIA programmable |
| Battery | Included |
| Dimensions (approx.) | 9.6 cm (W) x 14.4 cm (L) x 1.9-3.2 cm (H) |
| Weight (approx.) | 0.3 kg |
| Application | Desktop, Laptop, Number, Tablet |

3. Package Contents
The ZUOYI GMK21 Keyboard Kit typically includes:
- ZUOYI GMK21 Keyboard Kit (barebone, without switches and keycaps)
- USB Cable
- 2.4G Wireless Receiver
- Switch Puller (for hot-swapping switches)
- User Manual (this document and a PDF version)

4. Setup
4.1. Physical Assembly
As a hot-swappable kit, the GMK21 requires assembly of switches and keycaps.
- Unpack all components of your keyboard kit.
- Carefully insert your preferred 3-pin or 5-pin mechanical switches into the hot-swap sockets on the PCB. Ensure the pins are straight to avoid bending.
- (Optional) Install stabilizers if they are separate from the PCB.
- (Optional) Place your chosen keycaps onto the switches.
- Assemble the upper cover and base shell of the keyboard.


4.2. Connection Modes
The ZUOYI GMK21 supports three connection modes: Wired, Bluetooth, and 2.4G Wireless. Use the toggle switch on the top-left of the keyboard to select your desired mode.
4.2.1. Wired Mode
- Set the toggle switch on the top-left of the keyboard to the middle (USB) position.
- Connect the provided USB cable from the keyboard to an available USB port on your computer.
- The keyboard backlight will illuminate, indicating a successful wired connection.
4.2.2. Bluetooth Mode
- Set the toggle switch on the top-left of the keyboard to the left (Bluetooth) position.
- One of the keys (1, 2, or 3) will flash. Press and hold
FN + 1,FN + 2, orFN + 3for 3-5 seconds until the corresponding key's LED rapidly flashes blue. This indicates the keyboard is in Bluetooth pairing mode. - On your device (computer, tablet, smartphone), enable Bluetooth, search for available devices, and select "GMK21-1", "GMK21-2", or "GMK21-3" (matching the
FNkey you pressed) to pair. - Once successfully connected, the LED on the corresponding key will stop flashing and remain lit.
- To switch between up to three paired Bluetooth devices, short press
FN + 1,FN + 2, orFN + 3. - The keyboard will automatically attempt to reconnect to the last used Bluetooth device when powered on.
4.2.3. 2.4G Wireless Mode
- Set the toggle switch on the top-left of the keyboard to the right (2.4G) position.
- The '4' key will flash green.
- Insert the 2.4G wireless receiver into an available USB port on your computer.
- The '4' key will stop flashing and the keyboard backlight will turn on, indicating a successful 2.4G wireless connection.
5. Operating Instructions
5.1. Knob Function
The rotary knob located on the top-left of the keyboard controls audio volume:
- Clockwise rotation: Increase volume.
- Counter-clockwise rotation: Decrease volume.
- Press down: Mute/Unmute audio.
5.2. LED Backlight Settings
The keyboard features RGB backlighting with various adjustable settings:
FN + +: Increase RGB backlight brightness.FN + -: Decrease RGB backlight brightness.FN + *: Increase RGB backlight hue.FN + /: Decrease RGB backlight hue.FN + 5: Increase RGB backlight saturation.FN + 6: Decrease RGB backlight saturation.FN + 7: Decrease RGB backlight effect speed.FN + 8: Increase RGB backlight effect speed.FN + ENTER: Switch between different backlight effects.FN + Backspace: Turn the key area backlight on or off.

5.3. Automatic Sleep Mode
- Wireless Modes (Bluetooth & 2.4G): The backlight will turn off after 3 minutes of inactivity. Press any key to wake the keyboard.
- Bluetooth Deep Sleep: After 30 minutes of inactivity in Bluetooth mode, the keyboard enters deep sleep, and the Bluetooth connection will disconnect. Press any key to exit deep sleep, and the RGB backlight will come on, automatically reconnecting to the last paired Bluetooth device.
5.4. Charging and Battery Indicator
- Low Battery: The
FNkey will continuously flash red when the battery level is below 3.4V, indicating that the keyboard needs charging. - Check Battery Status (Wired Mode): Press
FN + .. If theFNLED shows red, the keyboard is charging. If it shows green, the keyboard is fully charged. - Check Battery Status (Wireless Mode): Press
FN + .. Keys 1 through 0 will light up, representing 10% to 100% power respectively. ReleaseFN + .to exit the power checking display.
5.5. Custom Settings (QMK/VIA)
The ZUOYI GMK21 supports QMK/VIA for advanced key mapping and customization. Ensure your keyboard is properly connected via USB to your computer before proceeding.
5.5.1. VIA Software Installation
- Visit https://github.com/WestBerryVIA/via-releases/releases to download and install the latest VIA software for your operating system, or use the web driver at https://usevia.app/.
- Download the
ZUOYA GMK21.JSONfile from the official ZUOYI website. - Open the VIA software. Click the "Load" button and import the downloaded
ZUOYA GMK21.JSONfile. - Once loaded, VIA should automatically detect your compatible keyboard.
5.5.2. Key Remapping
In the VIA software interface:
- In the upper section of the VIA software page, click on the key you wish to remap.
- In the lower section of the VIA software page, click on the desired new function or key assignment. The change will take effect immediately.

5.5.3. Macro Settings
The ZUOYI GMK21 does not have dedicated macro keys. However, you can map custom macros to any key using the VIA software to achieve quick operations.
5.5.4. Layer Management
The keyboard features 4 default layers (0-3) for different operating systems and extended functionalities:
- Layer 0: Activated when the keyboard is connected to a Windows system.
- Layer 1: Activated when the keyboard is connected to a Mac system.
- Layer 2: Activated by long-pressing the
FNkey when connected to a Windows system. - Layer 3: Activated by long-pressing the
FNkey when connected to a Mac system.
5.5.5. DFU Mode
To enter DFU (Device Firmware Upgrade) mode, ensure the keyboard is in wired mode, then press and hold the FN key while plugging in the USB cable.
5.6. Factory Reset
To restore the keyboard to its factory default settings, press and hold FN + 0 for 3 seconds.
6. Maintenance
6.1. Cleaning
- Use a soft, dry cloth to wipe the surface of the keyboard.
- For deeper cleaning, gently remove keycaps and switches using a switch puller. Clean the plate and PCB with compressed air or a soft brush to remove dust and debris.
- Avoid using harsh chemicals or abrasive materials that could damage the keyboard's finish.
6.2. Switch Replacement
The hot-swappable design allows for easy replacement of mechanical switches without soldering:
- Using a switch puller, gently grip the top and bottom clips of the switch and pull upwards to remove it from the socket.
- Align the pins of the new 3-pin or 5-pin compatible mechanical switch with the holes on the PCB.
- Gently press the new switch into the socket until it clicks into place. Ensure the pins are not bent during insertion.
7. Troubleshooting
| Problem | Solution |
|---|---|
| Keyboard not recognized by VIA software |
|
| Bluetooth connection issues |
|
| 2.4G wireless connection issues |
|
| Backlight not working or dim |
|
| Keys not responding or inconsistent input |
|
8. Warranty and Support
For further assistance, warranty information, or to download the official PDF user manual, please visit the ZUOYI official website or contact their customer support. A detailed user manual (PDF) is available at: https://manuals.plus/m/f3d147eeb8b0573d2e4ef81d6e81593595be313cfc9ece42a9979c7dd393717d