Skip to content
/ GK6X Public
forked from pixeltris/GK6X

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

License

Notifications You must be signed in to change notification settings

bon3less/GK6X

 
 

Repository files navigation

GK6X

This is a command-line tool for mapping keys, macros, and lighting for GK6X keyboards (GK64, GK84, GK61, etc). This can be used as an alternative to the official software (Windows / Mac).

It runs on Windows, Mac, and Linux.

System requirements / compilation

See the releases page for prebuilt binaries.

.NET Framework 4+ on Windows. mono on Mac / Linux. Expand for more info.

Windows

.NET Framework 4+ is required (should be pre-installed on Windows 7 and higher).

To compile from source you have two options:

  • Run GK6X/GK6X.bat
  • Compile using Visual Studio (C# tools required)

Linux / Mac

mono is required (most Linux package managers should list mono-complete).

Compiling may take several attempts depending on the version of mono. Try xbuild GK6X.sln, or msbuild GK6X.sln, or xbuild /p:TargetFrameworkVersion=v4.5 /p:TargetFrameworkProfile="", or ask for help in #4.

cd into Build and run with sudo mono GK6X.exe. Super user (sudo) is required on Linux (possible hidraw issue). Or use the udev rule below.

Linux AUR package

GK6X is available in AUR as package gk6x-bin maintained by @aakashhemadri.

Linux sudo alternative (udev rule)

An alternative to using sudo is to set up a udev rule. Create /etc/udev/rules.d/gk6x.rules:

SUBSYSTEM=="input", GROUP="input", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1ea7", ATTRS{idProduct}=="0907", MODE:="666", GROUP="plugdev"
KERNEL=="hidraw*", ATTRS{idVendor}=="1ea7", ATTRS{idProduct}=="0907", MODE="0666", GROUP="plugdev"

Then add yourself to plugdev and reboot for it to take effect:

sudo adduser $(whoami) plugdev

Overview

Once the program is opened you should see something like:

Connected to device 'GK84S RBG' model:655491200 fw:v1.16

At this point you can start using mapping your keyboard with the map command as seen below.

If you don't see any output, it has failed to detect the keyboard. There isn't any console output until it finds a valid keyboard.

Commands

map

Maps the keyboard based on the config in UserData/YOUR_MODEL_ID.txt. See Sample.txt for examples of setting keys, macros, and lighting.

You can reprogram the base layer, layers 1-3, and layers 1-3 whilst the fn is held down. You can't move the fn key, but TempSwitchLayer1/2/3 can act similar to a secondary fn key. The base layer fn key set can't be mapped.

unmap

Resets the keyboard to the default config. The dedicated reset keyboard key combo will be more effective; refer to your manual.

gui

Starts the GUI web server on http://localhost:6464 (requires the GUI build from the releases page).

If you're running from source you'll need to copy the driver folder from a release build. For updating the GUI files see updating.txt.

gui_le

Copies the lighting files created using the gui to the Data/lighting/ folder so that the map command can use them.

Additional commmands

These commands generally aren't needed.

dumpkeys

Lists the textual name / code name (i.e. 5 is D5) of the keys listed in the order that they appear on each row of your keyboard. This shows the keys represented prior to any mapping, and is just a reference.

findkeys

Tool to identify key names. Used for finding broken keys and fixing data files.

update_data

This is used to update the data files from the official software. This exact process needs to be re-documented (Updating.txt).

Additional info

  • The /p command line arg can be used to set a prefixed file name of the config to use. For example GK6X.exe /p test will use test - 655491200.txt as the target config file (where the keyboard model id is 655491200).
  • The following commands can be used as command line args to just execute a specific command /gui, /map, /unmap, /dumpkeys. For example: GK6X.exe /map
  • The data files for the gui command aren't included in this repo. Obtain them from a release build.
  • There's possibly some issue with certain USB slots (#102).
  • There is no "apply failed" message like there is on the official software, so map / umap can fail silently.
  • There are issues with the web GUI such as not being able to map the base layer. I'd recommend avoiding the GUI if possible.

The web GUI looks like this:

Alt text

Related projects

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 89.0%
  • C# 9.1%
  • C++ 1.7%
  • Other 0.2%