Aug 24, 201848391 views

How to Configure your CTRL Keyboard!

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/tag/1.0.3. 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.
thumb_up
JaRew, RangmanAlpha, and 55 others
thumb_up57
731
remove_red_eye48.3K
bookmark_borderSave


Stickied
Hi all, we have new updates to mdloader, our keyboard configurator, and our fork of QMK. If you have previously downloaded the mdloader tool. Please download the latest version at: https://github.com/Massdrop/mdloader/releases/tag/1.0.3 This new version of mdloader adds a new "--first" option that auto-detects the first available keyboard to flash over the next 60 seconds. Using --first, you can submit the flashing command with your CTRL keyboard and then press the reset button---no second keyboard needed. It also adds .hex file support. In a few weeks, we will be switching the keyboard configurator to output .hex files instead of .bin files, so it's important that you download this new version of mdloader. Our keyboard configurator has been updated with the following: - New keycode MD_BOOT: hold for a second and then release to reset the keyboard. No more needing to keep a pin handy to flash your CTRL keyboard! - Support for the ALT Keyboard We have updated our fork of QMK with the latest from the main QMK repository. This includes MD_BOOT support and other changes. We are working on getting changes on our fork back into the main QMK repository.
Stickied
If you're trying to load firmware onto your CTRL Keyboard and wondering where the reset button is: reset button is in the hole on the left side bottom of the keyboard. Use a pin or something thin to press it.
search
Load 14 more comments
Hey, pick up the new version of mdloader which has a new command option that auto-detects your keyboard for the following 60 seconds so you don't need a second keyboard.
https://github.com/Massdrop/mdloader/releases/tag/1.0.3
See updated readme here: https://github.com/Massdrop/mdloader
jxliu
🙇‍♂️ thank you so much for adding that feature.
However, "you should lead with that next time" 😉 https://youtu.be/Nx2mhPEr7kA?t=129
(then again, maybe I'm the only person that was bothered by the 1.0 approach. 😆)
Thanks again!
Will this allow me to set the color of the LEDs to whatever I want, instead of just one of the 9 preset colors that I don't want? Why isn't ORANGE available??? There should be a way to set 16 levels of EACH RGB channel so we can make any color we want...just like every other RGB LED keyboard out there. :-p
captain
Sure, any color or effect, but you should train your programming skills to do this :)
So I suddenly started having issues with the keyboard inputting double-key presses, like the word I type would randomly have duplicate letters in them. Anyone else have the same issue?
Load 4 more comments
There was more discussion about this problem here (and another thread that I can't find): https://www.massdrop.com/buy/massdrop-ctrl-mechanical-keyboard/talk/2330971
ldeak
So... nothing we can do about it? Anyone we can talk to at Massdrop regarding this?
How to change the default lighting? I don't know how to use the QMK,I just want white LED.
(Edited)
VocAl
You can do that via the configurator. You don't need QMK. https://www.massdrop.com/mechanical-keyboards/configurator Just select all of the keys and backlight LED's and set them to white for all layers.
search
That being said, the GUI is pretty limited https://github.com/LastContinue/ctrl-info/wiki/FAQ-GUI
(Edited)
I started getting compiler errors after I updated some of the items in the compiler tool-chain (MacOs) . Pulling down the newest version of QMK fixed the issue, but they key-by-key code stuff isn't in there yet. I figured "I'll just use Docker" and that worked too, but "ugh" slow. So I made my own version. https://github.com/LastContinue/qmk_firmware/tree/lc_key-by-key To keep compatibility with QMK master, I moved all of the key-by-key code into files that only the keymap "lastcontinue" can access (this also gives you map-by-map capslock settings) If you want to make your own keymap from this, it's trivial by just copy-pasting. Of course I have some of my own personal settings in there, but those are easy enough to edit around (I have my brightness turned way down by default), but pay attention to the comment at the bottom about commenting code out if you don't want key-by-key and for some reason are using that map. Numbers at the bottom come from "light math", see https://github.com/LastContinue/ctrl-info/wiki/Light-Math and https://github.com/LastContinue/ctrl-info/blob/master/led_map.png
https://github.com/LastContinue/ctrl-info/blob/master/scripts/leds.py or https://github.com/LastContinue/ctrl-info/blob/master/scripts/leds_python3.py for tools to help you build those out Also, I already linked to it, but you might have noticed, I finally updated my wiki to include a more reasonable and up-to-date version of how to do key-by-key color setting via QMK https://github.com/LastContinue/ctrl-info/wiki/Light-Math
(Edited)
Has anyone else been having trouble with being able to compile&download from the online configurator? Mine seems to be hanging permanently despite no configuration inputs that I can see that have issue (see attached screenshots)
search
search

Load 2 more comments
nhk_hens
I'm having the same issue with CTRL keyboard
nhk_hens
It should work again!! :)
search
Hi I do have the applet-flash file in the same folder as the mdloader_mac; however, I'm still receiving the error that the applet file cannot be open.
KTGAMER
Move your working directory (cd) to the location of the executable/bin file
I can't flash the keyboard with the new .bin from the configurator and the new version of mdloader in Mojave 10.14.3 on my Mac. Keeps getting "command not found" error. applet.bin and mdloader_mac.dms downloaded and saved to ~/Desktop/mdloader-master/. Saved configurator .bin to same location. Ran make. Tried mdloader_mac.dms —first —download massdrop_ctrl_md_configurator_1550014602)_994398888.bin, yields "no command found". What am I missing?
iakobou
resolved! had to use ./ prefix: ./mdloader_mac.dms —first —download massdrop/file/path.bin —restart
For some reason, the software is unable to detect my keyboard and it just times out after scanning for 60 seconds. Anyone else having the same issue?
Load 1 more comment
Thanks! That did the trick.
Nyque
After you've flashed it with (just about any) firmware than the one that came on the board, you can just do "fn+b" for a couple of seconds, then let off. Beats having to flip the board over if you're doing a bunch of programming.
Great keyboard, but the LED settings are very poor. I would really like to be able to adjust fade effect in the default firmware, for example.
Hi, is there any way to save the LED setting for the CTRL keyboard? I want to use the 2nd LED setting but everytime I restart my PC it went back to the first setting.
jackhp19
I'm having this same issue. CTRL will not default to my previous LED setting after a PC reboot or shutdown.
Is it possible to turn off the keyboard lights when my screen is off? Thanks
Load 1 more comment
I really wanted it to be automated . I'm currently using the Fn+X function but I wanted it automatic.
PYRON666
This is going to be more dependent on your OS than it is the keyboard. I'd look into searches like "cutting usb power on sleep" or something along those lines.
So I found Massdrop's fork of qmk. Its so old and outdated I dont know if i want to use it. Seems like a few of the commits have not been merged into qmk and they are extremely behind (216 commits behind qmk). Any idea when this will be synced with a way to create led programs in my user folder for the ctrl?
realistically, are we ever getting macro support?
Hi, I may have missed it, but can you change colors to be a solid color. Thanks.
So, can we assume that development (the missing points on the roadmap) is discontinued then, I mean specifically 2 and 3.
(Edited)
Load 6 more comments
Holy crap this is great. Will pull soon and start fiddling
slugger7
If you get anything cool, put a link here! Valen's stuff is too much for me both in effect and in code (Almost 1000 loc? WOW) for me to casually look through, but I'd suppose there's some bits and pieces that could be taken out for a more simplified effect, and for nothing else, than to have more links to stuff for my wiki project 😉
How would I go about adding a breathing effect to a single key? I'm trying to have my space bar, escape key, and backspace key breathing.
designgears
I've been working to make my own version of this, but his is way nicer! Watch that demo video: https://www.youtube.com/watch?v=W3U1SDztx1I
How can people afford this keyboard? 😯
bial654321
Jobs
search

Load 1 more comment
You have to make sure the applet flash file is in the same folder as mdloader_windows.exe. It is the first file in the github link with the mdloader exe. https://github.com/Massdrop/mdloader/releases/tag/1.0.3
MalikEid
Thanks!
I'm able to flash the firmware and everything... The F13-24 keys are not working. I've reflashed multiple times, but when I set F13-24 keys, they don't do anything. The layer that's with those keys still works properly, and I'm able to hit all the other F1-12 keys (all of these are on the same layer). Is this a problem with the QMK Configurator? QMK mdloader? I've been wanting to get this fixed, but nobody to help, since massdrop support just tells me to discuss it here.
ctrl-info Repo Update: As there are even more holidays approaching, I decided to finally get off my butt and package a release for some of the stuff I changed in the repo awhile back. So if you're using the drag and drop loaders, here's a new version for you! https://github.com/LastContinue/ctrl-info/releases/tag/v0.3.1 There's some brief instructions there so I won't repeat myself here. The biggest change is that everything uses mdloader 1.0.3. The ctrl-ldr.sh for Macs/Linux also handles all of the mdloader dependency fetching now (I found that really convenient for myself. The less I have to mess with Automator, the better) Powershell versions are more or less the same besides fetching and using mdloader 1.0.3 Like all of my other versions, all of the code can be found in the repo itself. I encourage you to look around as there's some more helpful stuff in there (like the python script I use to make light codes, or a script that builds QMK and then loads it with minimal input) Also, as usual, the Windows stuff probably works*. Everything is properly in Git now** so PRs welcome if you want to help me out. *I don't have access to the Windows machine I used the first time I wrote them, but the overall changes have been minimal. **for some reason I called that commit "MVC" when I meant "VCS" 🤔 😆, but I already tagged so I'm not force pushing to fix it! Edit: went back to find the original release post which has pictures https://www.massdrop.com/talk/9382/how-to-configure-your-ctrl-keyboard/2208117
(Edited)
I can't seem to run mdloader_windows.exe on windows 10. The moment I launch it, the cmd box looks like it just closes instantly.
iceweasel
You need to run it from powershell or cmd. Or you can download a drag and drop version (drop your .bin onto the shortcut) from here https://github.com/LastContinue/ctrl-info/releases/tag/v0.3.1
Can someone make a tutorial on how to customize the LED patterns? For example how do we take this guy's forked code and implement it into our own keyboards? https://www.youtube.com/watch?v=ntZn0AcSwt8


jimmyplaysdrums
That specific example is pretty complicated. Here's the post with the most information and code for "how I did it". I was able to download and built from one of the repos in that thread, and sure enough it gave a reactive pattern, however, the rest of the code in that repo is pretty out of date so stuff like macros and key combo reset don't work right. https://www.massdrop.com/talk/9382/talk/2187761?utm_source=linkshare&referer=2FNFUD
Is anyone having this problem where each time that i press certain letter it won't register ? I tried fixing the problem by: moving the switch around, reinstalling by resetting the keyboard and reinstalling the default configuration, reconnecting and disconnecting the keyboard and trying the keyboard on a different computer. All of these methods don't work. Does anyone have any suggestion on how to fix the issue.
Is it possible, using this software alone, to speed up the input speed and delay of the keyboard? It's a function that I use a lot in gaming and already present in some boards even without software (Leopold, Zowie, Ducky ecc). Will this feature be available in the near future?
FrancescoDMR
up
Can a single low-lit color be programmed into this keyboard? Say white or cyan, without any rainbow or rolling effects?
LWNYC
Yes. You should already be able to select white from the default patterns. You can also select keys to just be white from the GUI configuator. the brightness is something you have to with QMK. I've documented it here: https://github.com/LastContinue/ctrl-info/wiki/FAQ-Lights
LastContinue
Thanks!
Please make another LED pattern like rain drop or reactive RGB and so on.
Have anyone encountered this problem. I am trying to flash ctrl keyboard using the latest update of QMK Toolbox but can't seen to find Mircocontroller for atsamd51. When looking online one comment said to use mdloader tool to flash but how to flash use mdloader ?
Load 4 more comments
FN + B, faster.
NINJER
fn + b isn’t on the firmware that ships with the keyboard so I left it off my previous comment. It’ll be there after updating to firmware compiled with the current configurator.