How-To Guides
Step-by-step tutorials for setting up your GMK87 keyboard, uploading custom images, configuring RGB lighting, and more.
Setup Guide
Install the GMK87 Configurator on macOS, Windows, or Linux and connect your keyboard for the first time.
Upload Images
Upload custom images and animated GIFs to the 240x135 display on your GMK87 keyboard.
Configure Lighting
Set up RGB underglow effects, adjust brightness, speed, and pick custom colors for your GMK87.
Lighting Presets
Browse all 19 built-in lighting effects and learn how to apply them via the app or CLI.
Frequently Asked Questions
How do I configure the GMK87 screen on macOS?
The official Zuoya software only works on Windows. The GMK87 Configurator is a free, open-source tool that lets you configure your GMK87 keyboard display, lighting, and clock on macOS, Windows, and Linux. Download the app from codedgar.github.io/gmk87-node or use the CLI.
How do I upload custom images to the GMK87 keyboard?
Use the GMK87 Configurator app to drag and drop images onto your keyboard display. The screen supports 240x135 resolution and accepts PNG, JPG, BMP, and animated GIFs up to 36 frames. You can also use the CLI:
npm run sendimage -- --slot0 yourimage.png
Does the GMK87 work on Linux?
Yes. The GMK87 Configurator supports Linux. Install the app or clone the repository and run
npm install. You'll need to set up udev rules for USB access: sudo cp 50-gmk87.rules /etc/udev/rules.d/
Is there a GMK87 software alternative for Mac?
Yes. The GMK87 Configurator is a free, open-source alternative to the official Zuoya software. It works on macOS, Windows, and Linux and provides the same functionality: image upload, lighting configuration, and time sync.
How do I change the RGB colors on my GMK87 keyboard?
Use the GMK87 Configurator app to visually pick colors, or use the CLI:
npm run lights -- --effect rainbow-cycle --brightness 5. The keyboard supports 19 underglow effects and custom RGB values.