Keychron K17 Pro QMK and VIA Wireless Custom Mechanical Keyboard User Guide
- June 15, 2024
- Keychron
Table of Contents
Keychron K17 Pro QMK and VIA Wireless Custom Mechanical Keyboard
Product Description
If you are a Windows user, please find the appropriate keycaps in the box, then follow the instructions below to find and replace the following keycaps.
Instruction for use
-
Switch To The Right System
Please make sure the system toggle on the top left corner has been switched to the same system as your computer’s operating system. -
Connect Bluetooth
Press fn + 1 (for4 seconds) and pair with device named Keychron K17 Pro. -
Connect Cable
-
The VIA Key Remapping Software Please visit usevia.app to use the online VIA software to remap the keys.
If the VIA cannot recognize your keyboard, please reach our support to get the instruction.
- The online VIA software can only run on the latest version of Chrome, Edge, and Opera browsers yet.
- VIA only works when the keyboard is connected by wire to the computer.
5. The Layers
There are four layers of key settings on the keyboard. The layer O and layer 1 are for the Mac system. The layer 2 and layer 3 are for the Windows system.
If your system toggle is switched to Mac, then the layer O will be activated.
If your system toggle is switched to Windows, then the layer 2 will be
activated. Remember that if you are using it in Windows mode, please make
changes to the layer 2 instead of the top layer {the layer 0).
This is a common mistake people are making.
- The Backlight
Press fn + Q to change the lighting effect
Press fn + tab to turn the backlight on/off
- Adjust The Backlight Brightness
Press fn + W to increase the backlight brightness
Press fn + S to decrease the backlight brightness
- Adjust The Backlight Speed
Press fn + T to increase the light effect speed
Press fn + G to decrease the light effect speed
-
Watch The Building Tutorial On Our Website
If you are building the keyboard for the first time, we highly recommend you watch the building tutorial video on our website first, then start building the keyboard yourself. -
Factory Reset
Troubleshooting? Don’t know what’s going on with the keyboard?
➀ Plug in the power cable and switch the keyboard to Cable mode.
➁ Factory reset the keyboard by pressing fn + J + Z (for 4 seconds).
➂ Download the right firmware and QMK Toolbox from our website.
➃ Switch the keyboard to OFF mode and remove the space bar keycap to find the
reset button on the PCB.
➄ Hold the reset key first, then switch the keyboard to Cable mode.
Release the reset key, and the keyboard will now enter DFU mode.
➅ Flash the firmware with the QMK Toolbox.
➆ Factory reset the keyboard again by pressing fn + J + Z {for 4 seconds).
Step by step guide can be found on our website.
Customer Support
Not Happy
Search “White backlight keymap” here to download the JSON file if VIA does not
automatically recognize keymap of the K17
Pro: https://www.keychron.com/pages/k17-pro-factory-reset-and-firmware-flash
VIA Software for macOS, Windows, Linux: https://usevia.app/#/
How to Use VIA on Your Keychron K Pro Series Keyboard:
https://www.keychron.com/blogs/archived/how-to-use-via-to-program-your-
keyboard
K17 Pro Source Code, please search “source code” on the product page on our official website.
References
- VIA
- VIA
- How to use VIA to program your keyboard – Keychron | Mechanical Keyboards for Mac, Windows and Android
- K17 Pro Factory Reset and Firmware Flash – Keychron | Wireless Mechanical Keyboards for Mac, Windows and Android
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>