Faalagorn / GK6X

Configure keys, macros, and lighting on GK6X keyboards (GK64, GK84, GK61, etc)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GK6X

This tool allows you to set keys, macros, and lighting for GK6X keyboards (GK64, GK84, GK61, etc). This can be used as an alternative to the official software http://www.jikedingzhi.com/downloadlist?driverID=41latest

It runs on Windows, Mac, and Linux.

Usage

Note: This is a CLI program (no GUI). It's advisable to use the official software if you're on Windows.

Note: On linux you will need to run with sudo (issue with hidraw?). It can be compiled / ran with mono on Linux / Mac. On Windows you compile it with Visual Studio.

When you open the program it will connect to your keyboard (there's no console output until it finds something to connect to).

Once it has connected it will create a file UserData/YOUR_MODEL_ID.txt. This can be used to configure the keyboard. See Sample.txt for examples of setting keys, macros, and lighting. Use the 'map' command to apply your changes to the keyboard, and 'unmap' to reset your keyboard to the default state (NOTE: There is no 'apply failed' message like there is on the official software, so it can fail silently!).

You can reprogram the base layer and layers 1-3 (and the Fn keys). The 'driver' layer isn't supported. The firmware doesn't allow you to reprogram the Fn keys on the base layer (which sucks!).

Alt text

Usage (Web GUI)

There's some very basic (and mostly untested) support for a web GUI by using the official software's web component. Use the 'gui' command to start the web server (it should automatically open the web page at http://127.0.0.1:6464).

Note: This repo doesn't contain the web files. Copy and paste the official software's folder into the "Build" folder, or use the pre-bundled version on the releases page.

Alt text

Related projects

https://github.com/wgwoods/gk64-python - thanks to @wgwoods for his work on annotating the dissasembly of the GK64 firmware.

About

Configure keys, macros, and lighting on GK6X keyboards (GK64, GK84, GK61, etc)


Languages

Language:JavaScript 66.9%Language:C# 27.5%Language:C++ 5.6%