Step-By-Step Guide To Configuring Your GMMK PRO Using QMK

Glorious HQ

July 28, 2021

QMK, or Quantum Mechanical Keyboard, is an open-source, community-centered configuration tool for keyboards and other input devices. The GMMK PRO supports QMK for remapping its keymap, allowing users to customize their board. QMK software is handy for creating layers, moving around specific keys, adding functions, etc.

QMK requires a simple setup process that can seem daunting at first, but we've designed this handy guide to make it quick and easy - getting you up and running with little hassle. Follow each step closely as we help you create your keymap, load it into QMK's toolbox configurator tool, and finally flash, or load, it onto your GMMK PRO.

The GMMK PRO also utilizes the Glorious Core software, so we will teach you how to revert your keyboard back to being able to utilize this proprietary tool.

A reminder that QMK Firmware on GMMK Pro will not be compatible with Glorious Core.

Once loaded, you will need to flash it back before you can take advantage of Glorious Core’s features.

Creating your keymap

1. Get your firmware by navigating to in your browser of choice.

2. Go up to the “KEYBOARD” dropdown box and select “gmmk/pro”

3. Use the tabs at the bottom to configure your keyboard layout.
a. ANSI contains your standard key functions for ANSI board layouts.
b. ISO contains your standard key functions for ISO board layouts.
c. Quantum contains the functions needed to access your board’s layers. In this tab, you will find the invaluable “MO” function that allows you to quickly swap between layers. For more information about working with layers in QMK, check out this handy video.
d. Keyboard Settings contains backlighting and RGB controls. Disclaimer: Currently, RGB lighting does not work on the GMMK PRO when utilizing QMK. We are working to address this issue as soon as possible.
e. App, Media, and Mouse holds assignable mouse, multimedia and application controls.

4. Define your keymap by dragging and dropping keymaps into their desired locations.

a. You can also click on an empty slot, then click on the keymap you want to be placed there.

5. To save this keymap you created for future changes, click the “Export Keymap” button. This will save the keymap as a .json file that can be imported later using the “Import Keymap” button.

6. Once you are satisfied with your keymap, compile your firmware using the “Compile” button. Once compilation is complete, the green button to “Download Firmware” will be available to click.

Loading your Keymap into qmk tool

1. Now that you have firmware ready to use, now you will want to flash that firmware onto your GMMK Pro. To do that first download the QMK Toolbox here:

2. For Windows users, download the file: qmk_toolbox.exe. Mac users download the file: QMK_Toolbox.pkg. Make sure to download the latest version.

3. Navigate to where you downloaded the QMK toolbox and open the file.

a. For some users, Windows will warn you when attempting to open this file. Check your antivirus and open using administrator access if necessary.

4. (Windows Only) When opening the QMK toolbox for the first time, you will be prompted to install drivers. If there is not a prompt to do so, right click at the bottom of the window and click “Install Drivers…”
a. This should only be done once unless there is an error downloading the drivers.
b.It is recommended you restart your computer after installing these drivers.

5. Launch the QMK toolbox again, and press the open button. Select the QMK keymap file you created in the “Creating Your Keymap” section. Press the open button once selected.

Note: Choosing the wrong keymap file here will cause your GMMK PRO to stop functioning, so be sure it is the correct file. Correcting this is as simple as opening up the correct firmware file.

6. Leave the “MCU (AVR) Only” dropdown at its default value - no need to change it.

Flashing your Keymap

1. To put your GMMK PRO into bootloader mode, you must first unplug it. Before plugging it back in, hold the SPACEBAR and B at the same time while plugging the cable back in.

a. You should see a message in the QMK Toolbox that indicates that your board is in STM DFU Bootloader Mode.

2. Click the “Flash” button to flash the keymap onto your board.

3. You can now close QMK Toolbox. Your new keymap is now successfully flashed to your GMMK PRO.

a. More detailed instructions and alternate ways of flashing are located here on this page in the QMK official docs:

(Alternative method) Hard Bootloader mode

1. Unscrew all the base plate screws on the backside of your GMMK PRO. Keep your screws in a safe place or on a piece of tape so you do not lose them.

2. Lightly tug on the base plate and lift the base plate 1-2 inches from the PCB board. Do this lightly and slowly as there is a 2-3 inch cable that is attached to the base plate and the PCB board.

3. You should see a button on the PCB board that is visible through the foam padding.

4. Simply hold this button down and plug the GMMK PRO back into the PC.

5. You are now in STM DFU bootloader mode.

6. Refer to Step 2 of Flashing Your Keyboard to continue with the flashing process.


1. Download the Glorious Core .bin file located here.

2. Launch the QMK Toolbox and press the open button once again under the Local File text box.

3. Leave the “MCU (AVR) Only” dropdown at its default value - no need to change it.

4. To put your GMMK PRO into bootloader mode, you must first unplug it. Before plugging it back in, hold "FN" + "\" for ANSI models and "FN" + "Backspace" for ISO at the same time while plugging the cable back in.

Note: These are the default key combinations for activating bootloader mode, and if they do not work, please reference your QMK keymap.

5. You should see a message in the QMK Toolbox that indicates that your board is in STM DFU Bootloader Mode.

6. Click the “Flash” button to flash the keymap onto your board.

7. You should now be able to close the QMK Toolbox if the file was successfully flashed onto the board. Your GMMK PRO should have full Glorious Core functionality once again.  


Q: Can I use Glorious Core after flashing my new keymap using the QMK toolbox?
A: No, you will need to flash the Glorious Firmware .bin file back onto the GMMK PRO to regain Core functionality.

Q: I chose the wrong keymap file, and now my GMMK PRO is not working properly. How do I fix this?
A: No need to worry, simply open up the file explorer in the QMK toolbox and reselect the proper keymap file.

Q: Do I need to choose an “MCU (AVR) Only” from the dropdown menu in the QMK toolbox?
A: No, the GMMK PRO does not require you to do so.

Q: How do I put my GMMK PRO in bootloader mode?
A: Unplug your GMMK PRO, hold the SPACEBAR and B simultaneously, and finally plug it back in. The GMMK PRO also has a physical button to initiate bootloader mode, and this required disassembly of the board. Please refer to “(Alternative Method) Hard Bootloader Mode” for more information on that.



I bought the GMMK 96% keyboard to use at work, and we use the Pause/Break key all the time in one program. Since that key is MIA – What combination equals this?

February 02, 2023


I’ve tried flashing gmmk/pro/rev2/ansi onto my gmmk pro and it causes the board to stop working. I had to follow the hardware bootloader method to flash glorious core back into ROM.

October 25, 2022


hey all, is it possible for someone to incorporate rotary and rgb to code please ? Can’t really follow up on all environment set to compile code and such. I know it’s an effort but if there’s a guide already there – would it be possible to incorporate the code within existing default lines ? unless there’s some harm around it. Apologies if any my lack of knowledge is causing you a headache.

March 22, 2022


Retracting my last comment about LEFT ALT. Turned out I had problems with a defect switch AND I had to clean out the socket with an air duster. Before that the key registered twice rapidly for almost each press.

February 17, 2022


If anybody wants to get their QMK’s rotary encoder to work, I’ve made a post on Reddit:

Also, many thanks to Alexey in the comments!

February 16, 2022



After switching to QMK I’m having a hard time with LEFT ALT – when I combine with for example CTRL and D in OneNote to get the time and date. Seems like I have to press all three keys almost at the same time to get it to work. Most often end up with nothing or D.

February 03, 2022


I flashed my keyboard with QMK how do I get the rotary encoder to work now?

February 02, 2022

DCamron Dunlap :

Can I use this same method on the gmmk 1 compact?

December 03, 2021


Anyone talk me through making a “send_string” macro and where I would put it in the keymap file?

December 01, 2021


Thank you Alexey and Johan!

Got my rotary knob to work on windows:
For my ISO board I had to edit following file: \keyboards\gmmk\pro\iso\iso.c
Than I compiled it with: qmk compile -c <Path to json-File from>
Than I flashed it with qmk_toolbox.exe (.bin location: .build\xxxx.bin)

Just insert at the end of iso.c:
bool encoder_update_user(uint8_t index, bool clockwise) {
if (clockwise) {
} else {
return true;

November 19, 2021


RGB is now working with qmk flashing!!! Thank you for fixing it!

October 13, 2021


Thanks, Alexey! I confirmed that building the firmware following, the volume control by the rotary knob is working.

September 16, 2021

Christopher Semyonov:

does this work with gmmk compact, theres so little info about this keyboard on internet

September 13, 2021


Thank you Alexey. I’ve used QMK MSYS to configure my GMMK Pro while keeping the rotary encoder KC_VOLU/KC_VOLD working.

September 07, 2021


Please add RGB support to the via firmware.

August 31, 2021


I got back into bootloader mode the second time (first time held SPACE + “B”) by holding does ESC while unplugged and replugging in. This worked to go from QMK back to the Glorious Core firmware.

August 27, 2021


so, it’s not clear to me. is the RGB toggle fixed yet? if so what key in QMK do i want to map it to becuase it appears tha RGB toggle isn’t working

August 18, 2021


it wont let me flash in the glorious firmware again im stuck in qmk

August 09, 2021


Looks like qmk rgb is working for anyone waiting

July 12, 2021


Getting volume support for the rotary knob on MacOS:

1. Install the QMK CLI environment (see
2. Add the following to the end of the file `qmk_firmware/keyboards/gmmk/pro/pro.c`

bool encoder_update_user(uint8_t index, bool clockwise) {
if (clockwise) {
} else {
return true;

3. Create a layout using the QMK Configurator and save the JSON file somewhere. Make sure to map “Quantum/Reset” – it’ll make your your life easier.
4. Compile your layout with `qmk compile -c ./gmmk_pro_layout_mine.json`
5. Flash the resulting `gmmk_pro_gmmk_pro_layout_mine.bin` to your keyboard

July 12, 2021


After flashing QMK and back to stock firmware ((QMK)GMMK _PRO_US_2021_04_07_V0035_DFU_FW.bin), I also lost RGB functionality.

July 12, 2021

James K:

is there a fix to the rgb problem that this installation creates? I am really wanting to have my rgbs work on my keyboard again.

July 06, 2021


For folks looking for updates regarding Glorious Core, QMK, or VIA updates, you can review the Development Roadmap here:

RGB support is in progress and you can follow the PR on github here:

July 06, 2021


I was able to update and flash the firmware with QMK MSYS on Windows using their command line package and retain the rotary encoder volume functionality. Here is a link for anyone who is interested:

The instructions can be found here:

You can also flash the firmware directly through CLI, no need to use the QMK Toolbox.

The main reason this works is that the CLI version retains a few lines of code in the keymap file to keep the volume functionality (you could also remap it to a mouse scroll wheel for example). The code is this snippet:

bool encoder_update_user(uint8_t index, bool clockwise) {
if (clockwise) {
} else {
return true;

July 01, 2021


Backstory: I always use the lower left modifier key as my Fn key (mac style), and the Caps Lock key as my left Ctrl. When I discovered the Glorious Core software wouldn’t let me assign Fn to any key besides the default Fn key, I was left with no choice but to use QMK.

My keys are now all working great, but the tradeoff is that I have no RGB (and no volume control with the rotary knob, but I prefer using hotkeys for volume control anyway.)

Glorious, if you’re listening, if you could just add the ability to remap other keys to Fn in the Glorious Core software, I would be a happy customer! Or add RGB control to QMK (polling rate control and rotary knob control would also be nice, I guess). Either would suffice.

June 28, 2021


please add rgb lights to qmk :(

June 24, 2021


Still waiting for proper QMK support. It’s been months and features that were promised at release are still missing. The lack of RGB and encoder customization in QMK is extremely disappointing. And the lack of any replies from your side doesn’t help the situation.

June 24, 2021


Sooooo the encoder knob is a huge letdown. I just want to scroll left and right but apparently, that is too much to ask for?

June 23, 2021


For those wondering how to get the keyboard into bootloader mode again (without disassembly) in QMK Toolbox after the first flash (after which unplug, “space + b”, plug in, stops working), it looks like the default keyboard map you flash from QMK already has “Reset” mapped to "Fn + \ ". As long as you didn’t change this you can use this from the QMK Toolbox terminal to get the board into bootloader mode and ready to flash again (you can see what your keymap is by uploading your .json file to QMK Configurator, and click through the layers, mine was on the Fn layer (1)). I made a mistake in my first keymap and didn’t want to take the whole dang thing apart again to hit a reset button on the PCB, so hope this helps someone else out. Also thanks Glorious for this guide, it was very helpful for someone like myself who is new to QMK. You might want to add what I’m saying to the document though because it’s natural to assume first time QMK users are going to make a mistake on their first flash!

June 21, 2021


I got this because I wanted a rotary encoder back. Sucks to know it’s a just glorified knob. Glorious’ community management is pretty sad though. At least acknowledge the issue and give some impetus to it. Otherwise, I hesitate to ever trust their intentions to become a truly community-focused company.

Just another wannabe, glorious?

June 21, 2021

Leave a comment!