1. Introduction
This manual provides detailed instructions for setting up, operating, and customizing your GGBEE 12 Keys 2 Knobs Macro Mini Keyboard. This versatile mechanical macropad offers full key customization, multimedia control, and is designed for various applications including gaming, graphic design software (e.g., Photoshop, Premiere, Lightroom, Illustrator, After Effects), and general office tasks. It supports both USB wired and Bluetooth-compatible connections.

Figure 1: Product Overview with 12 keys, 2 knobs, and key features.
2. Product Features
- Customizable Macro Programming: Program your own macros with ease, allowing you to automate repetitive tasks and increase productivity.
- RGB Backlighting: Customize the keyboard's backlighting with a variety of colors and effects, adding a personalized touch to your setup.
- Mechanical Operation Style: Enjoy a tactile and responsive typing experience with the mechanical operation style, reducing lag and increasing accuracy.
- Connectivity: Supports both USB wired and Bluetooth-compatible connections (including 2.4G wireless for specific models).
- Driver-free Plug-and-Play: No driver installation required for basic functionality.
- Compact and Portable: Small and lightweight design, ideal for on-the-go use.
- Two USB-C Ports: Equipped with two USB-C ports (front and side) for flexible placement and usage.
- Three Layers of Customization: Divide settings into three layers to meet different usage needs and avoid multiple reconfigurations.
- Non-slip Mat: Features a silicone anti-slip pad at the bottom for stability.

Figure 2: Connectivity options and software compatibility.
3. Setup Guide
3.1. Software Download and Installation
- Download Software: Access the customization software from the following link: https://drive.google.com/drive/folders/16QgfaZ2z-0nCRmhwbc3WshUxUPLLtAmB?usp=sharing. Alternatively, you can contact customer service for the link.
- Extract (Windows): For Windows systems, decompress the downloaded ZIP file. Locate and run the executable file named
MINI_KEYBOARD.exe. - Install (Mac): For Mac systems, decompress the file, install the application, then find and run the corresponding tool from your applications.
Video 1: Demonstration of software download and key programming for the custom keypad.
3.2. Connecting the Keyboard
- Wired Connection: Connect the keyboard to your computer using the provided USB-C cable. The software interface should display "Device Connect" upon successful connection.
- Bluetooth Connection (Initial Setup): For Bluetooth models, the initial setup must be done while wired to a Windows computer. After configuring your settings, you can unplug the cable. The keyboard will remember your settings.
- Bluetooth Pairing (Wireless Version):
- Regular Bluetooth: Turn the wireless switch on the keyboard to the 'ON' position. On your computer (with Bluetooth function), search for the keypad and pair it.
- 2.4G Wireless (if applicable): Install the 2.4G receiver into a functional USB port on your computer. Turn on the wireless switch on the keypad; it will automatically connect.

Figure 3: Wired and Bluetooth connection options.
Note: Keyboard setting is only supported on Windows systems. After successful setup on Windows, the keyboard can be used with other systems like Mac/iOS/Android.
4. Operating Instructions
4.1. Key and Knob Customization
The customization software allows you to assign various functions to each of the 12 keys and 2 knobs. Each knob supports three functions: clockwise rotation, counter-clockwise rotation, and pressing.
- Open Software: Launch the
MINI_KEYBOARD.exe(Windows) or the installed application (Mac). - Connect Device: Ensure the keyboard is connected and the software shows "Device Connect".
- Select Key/Knob: In the software interface, click on the desired key or knob position in the "Key selection area" or "Knob selection area".
- Assign Function: Choose a function from the left-hand menu (BaseKeys, Ctrl Shift Alt, MutiMedia, RGB LED, Mouse/Swipe screen, DelaySetting, Procreate).
- Save Settings: After selecting the function, click the "Download" or "Save settings" button. A "Download success" message will confirm the update.

Figure 4: Software interface for basic key and combination key settings.
4.2. Layer Switching
The keyboard supports three independent layers for storing different key configurations. This allows you to quickly switch between different sets of macros for various tasks (e.g., one layer for gaming, one for design software, one for office work).
- Switch Layers: Use the dedicated "Layer button" on the keyboard to cycle through the layers. The layer indicator lights will show the active layer.
- Setting Layers: In the software, select the desired layer (1, 2, or 3) at the top of the interface before customizing keys. Remember which layer you are configuring.
4.3. RGB LED Lighting Effects
Customize the keyboard's backlighting to match your preferences.
- Access Settings: In the software, navigate to the "RGB LED" section.
- Choose Mode: Select from various lighting modes (LED-Mode0 to LED-Mode5). LED-Mode0 turns off the lights.
- Select Color: Choose a specific color for the keys.
- Apply: Click "Download" or "Save settings" to apply the changes.

Figure 5: Software interface for multimedia and RGB LED settings.
4.4. Advanced Settings (Multimedia, Mouse, Delay, Procreate)
The software provides advanced options for multimedia controls, mouse functions (including swipe gestures), time delay settings for specific scenarios, and dedicated shortcuts for Procreate.
- Navigate: Click on the respective functional module (MutiMedia, Mouse/Swipe screen, DelaySetting, Procreate) in the left menu.
- Configure: Follow the on-screen instructions to set up functions like Mute, volume control, mouse movements, or specific Procreate shortcuts.
- Save: Click "Download" or "Save settings" to apply.

Figure 6: Software interface for mouse/swipe and delay settings.

Figure 7: Software interface for Procreate shortcuts.
5. Maintenance
- Cleaning: Use a soft, dry cloth to clean the keyboard. Avoid harsh chemicals or abrasive materials.
- Battery (Wireless Version): When the battery level is low, the product will become unusable. Connect the keyboard via USB-C to charge it. The charging indicator will be red, turning green when fully charged.
- Storage: If not in use for a long time, it is recommended to turn off the wireless switch (for Bluetooth models) to conserve battery. The product enters sleep mode after 3 minutes of inactivity.
6. User Tips
- Hot-swappable Switches: This keyboard supports hot-swappable switches, allowing you to easily change out mechanical switches without soldering. This is useful for customizing the feel and sound of your keys.
- Bluetooth Backlight: In Bluetooth mode, the keyboard's backlight will turn off to extend battery life.
- F13-F24 Limitation: Note that F13-F24 key options cannot be used during Bluetooth connection.
7. Troubleshooting
- Question 1: No response when the keyboard is connected to the computer, or the device is prompted abnormally.
- Solution: Check whether the cable and interface are properly connected. Re-plug the USB cable. Try using a different USB port on the computer.
- Question 2: After downloading the custom software, it cannot be opened.
- Solution: Check if your antivirus software is blocking the operation. Add the software as a trusted file or temporarily disable the antivirus during installation/first run.
8. Specifications
| Feature | Detail |
|---|---|
| Brand Name | GGBEE |
| Communication Method | Bluetooth-Compatible, USB Wired |
| State of Assembly | Ready-to-Go |
| Camera Equipped | No |
| High-concerned chemical | None |
| Origin | Mainland China |
| Keys | 12 |
| Knobs | 2 |
| Dimensions (approx.) | 76.8mm (width) x 138.5mm (length) x 14.5mm (thickness) |
| Compatibility | Windows (for setup), Mac/iOS, Android (for use after Windows setup) |
| Battery Life (Wireless) | Approx. one month on full charge (backlight off) |
| Ports | 2x USB-C (front and side) |

Figure 8: Keyboard dimensions and portability.
9. Warranty and Support
For further assistance, please refer to the official user manual PDF available at: User Manual (PDF). You can also find the latest software and support information on the product's download page: Software Download Link.
Please note that specific warranty details are not provided in the product information. For warranty claims or additional support, please contact the seller directly.





