shopping_cart

How to Configure your CTRL Keyboard!

more_vert
search
Hey everybody! Thank you for purchasing your Massdrop CTRL Mechanical Keyboard. We hope you’re enjoying it so far. If you’ve landed here, you probably want to take full advantage of the keyboard’s features so you’ve come to the right place. We’ll start with the basics, then we’ll move on to complete custom configuration.
THE BASICS
Default Hot Keys Hold FN + listed keys to activate LED Keys
Fn + A: LED Pattern Select Previous Fn + D: LED Pattern Select Next Fn + W: LED Brightness Increase Fn + S: LED Brightness Decrease Fn + Q: LED Scrolling Pattern Speed Decrease Fn + E: LED Scrolling Pattern Speed Increase Fn + Tab: LED Toggle Breathe Effect Fn + Caps Lock: LED Toggle Scrolling Pattern Direction Fn + X: LED Toggle On/Off Fn + Z: LED Toggle Mode (Keys+Edge, Keys Only, Edge Only, Only modifiers) Media Keys
Fn + Page Up: Volume Up Fn + Page Down: Volume Down Fn + Print: Mute Fn + Insert: Play/Pause Fn + Home: Stop Fn + Delete: Previous Fn + End: Next Keyboard Option Keys
Fn + N: Toggle keyboard 6KRO/NKRO (Default state 6KRO)
CUSTOM CONFIGURATION
How do I configure my keyboard? Note: You will currently need a second keyboard to complete the 3rd step of this process. 1. Create your configuration. 2. Compile the firmware with your configuration. Use our web-based configurator tool to handle both steps at once: https://www.massdrop.com/mechanical-keyboards/configurator . See below for more information about our configurator. If you are comfortable with programming and want to use QMK functionality that our configurator does not support, you can manually create and compile your configuration by checking out the official QMK repository: https://github.com/qmk/qmk_firmware . CTRL Keyboard is in the folder "massdrop/ctrl". QMK setup instructions are here: https://docs.qmk.fm/#/newbs 3. Load the firmware onto your keyboard. To load the firmware onto your CTRL keyboard, download the appropriate loader application for your computer's OS here: https://github.com/Massdrop/mdloader/releases. Then follow the instructions here: https://github.com/Massdrop/mdloader . We are working with Jack and the other QMK contributors to get the loader application integrated into the next version of QMK Toolbox to simplify this loading process.
MASSDROP KEYBOARD CONFIGURATOR
https://www.massdrop.com/mechanical-keyboards/configurator When you first go to the configurator, you will be prompted to choose your keyboard (only CTRL Keyboard available for now). After choosing, you will see a top-down view of the keyboard and a layer selector on the right side. By clicking on a key, you can customize its behavior by selecting another key or function in the panel that appears below the keyboard. The currently available behaviors are: - Keys - Individual keys such as letters, numbers, media keys, and function keys. - Layer - Activate and deactivate layers. The CTRL Keyboard ships with a keymap where the Fn key activates layer 1. - Modifier - Send multiple modifiers with a single key press or allow a key to be a modifier when held and another key when tapped. - Special - Behaviors specific to the keyboard. For the CTRL Keyboard, these control the LEDs. After you have configured the behaviors to your liking, click the "Compile & Download" button in the top right to download the compiled firmware for your configuration. This typically takes around 30 seconds. You will need to load this compiled firmware onto your keyboard. See step (3) above for instructions. If you are logged in to Massdrop, you will see a "Save as a New Copy" button next to the "Compile & Download" button. Clicking this button will save your configuration, allowing you to revisit it and modify it. The next time you go to the configurator, you will see your saved configurations above the list of keyboards. About Layers Layers allow you to configure your keyboard with more behaviors than its number of physical keys. For example with the CTRL Keyboard, by default, when you hold Fn + A to change the LED pattern, the keyboard is actually activating Layer 1 and sending the code for switching to the previous LED pattern. The physical key that is mapped to the letter A on Layer 0 is mapped to changing LED patterns on Layer 1.
search
For each key, its behavior is determined by the highest active layer. For the highest active layer, if the key's behavior is "transparent" (denoted by a grayed-out "(trns)" on the keyboard display), then it falls back to the next-highest layer where its behavior is not transparent. The QMK documentation has some tips for working with layers: https://docs.qmk.fm/#/feature_advanced_keycodes?id=working-with-layers

Configurator Development Roadmap Our configurator tool is still a work-in-progress. Here is what you can expect to be added to the tool in the future: 1. Merge our QMK changes back into the main QMK repository 2. Macros support 3. Support for changing some QMK settings 4. Support for more keyboards
Having any issues or generally need some help?
Let us know in the discussion and we’ll give you a hand.
(Edited by moderator Elbert)
113
1.1K
remove_red_eye
214.6K

search
close
JohnAtl
0
Oct 17, 2021
I'm logged in, but don't see the Save a Copy button. Any help?
asmith10a
2
Oct 8, 2021
Anyone know how to fix the keyboard just not working at all.
ptrxyz
3
Sep 22, 2021
Can we please get the upstream merge? The configurator does not support some keys (i.e. F13 -> F24). And any news on the Macros? They were promised forever and I wonder if they'll ever come to live...
Kodachrome128
1
Sep 21, 2021
Is anyone else's CTRL keyboard really dim, even at full brightness? The characters on the keys are barely legible when under a lamp, and it's way dimmer than my old Cooler Master keyboard from 5 years ago, even though this costs about 3 times as much.
Jon25
0
Sep 10, 2021
This is the stupidest setup ive ever seen. Nothing even happens when i press the FN key which i assume is SYS
Kodachrome128
1
Sep 21, 2021
Its MO() tho
domoaligato
35
Sep 8, 2021
How goes the roadmap? please merge with upstream and enable VIA support.
christianareas
18
Sep 3, 2021
How do I delete a configuration?
domoaligato
35
Sep 8, 2021
I had to just overwrite my saved profile with an empty one. :|
tmk1991
0
Sep 3, 2021
When creating the CTRL web-based configurator tool it is only creating changes for colors and not for any key bindings. Using latest flashing software. I tried with no color changes and just key binding changes and no luck. Changing on layer 0.
ouneh
6
Aug 17, 2021
looks like there is either bug in configurator or wiring on some ctrls not matching... but looks like some of the base LEDs are flipped on either end. see attached images for the effect.
search
search

andrearonsen
3
Aug 4, 2021
I found the simplest way for me to flash the keyboard on Mac if someone is interested: Prerequisite: Homebrew brew install qmk/qmk/qmk brew tap homebrew/cask-drivers brew install --cask qmk-toolbox qmk setup => Answer Y to all questions qmk config user.keyboard=massdrop/ctrl qmk config user.keymap=<mykeymapname> cd ~/qmk_firmware/keyboards/massdrop/ctrl/keymaps cp -R mac_md <mykeymapname> Edit keymap in your favorite editor: ~/qmk_firmware/keyboards/massdrop/ctrl/keymaps/<mykeymapname>/keymap.c qmk compile Flashing ======== 1. Start Qmk Toolbox GUI application 2. Select file ~/qmk_firmware/massdrop_ctrl_<mykeymapname>.bin 3. Hold fn+b until lights go off to put keyboard in flash mode 4. Press Flash 5. Wait for LEDs to light up again 6. Finished. Works like a charm :-)
jasonmklug
0
Aug 23, 2021
Thanks for this step-by-step! Worked cleanly for me. The only bump I encountered was in the `qmk_setup` step. I got these two errors: ``` Can't find arm-none-eabi-gcc in your path. Can't find avr-gcc in your path. ``` But they were only not in my path because I'd neglected to close & re-open my terminal window. Once I did that, the rest of the steps worked a treat.
Showing 13 of 310
keyboard_arrow_up
Newest
310 OF 310 POSTS
keyboard_arrow_down
Oldest