kbdctl

README

Kbdctl

Currently supported keyboards:

• Zuoya GMK87 (time synch only)

Installation

• Download the latest binary from the release for your Operating System
• Unpack
• See [usage][#usage]

Zuoya GMK87

Problem: the supplied image and time synchronisation tool only works on Windows.

Jochen Eisinger did a great job reverse engineering the protocol and creating a python script for configuring the display GIF and synchronising time. USB interaction in this project is basically 1-to-1 rewrite in Go, everything in kbd package, so far, is a derived work from a BSD licensed zuoya_gmk87.py script, (c) Copyright 2025 Jochen Eisinger.

This project's main purpose is to have a single binary for time synchronisation. If you need to upload GIFs into the keyboard, use the original script.

Usage

kbdctl -set-time

Known issues:

• The keyboard is not reattached after the time synchronisation, it's necessary to either turn it off and on again, or to plug the USB cable out and plug it in again.