Skip to content

Instantly share code, notes, and snippets.

@schmich

schmich/ducky.md

Last active Nov 23, 2020
Embed
What would you like to do?
Programming media keys on the Ducky One 2 Skyline

Programming Media Keys on the Ducky One 2 Skyline

To use media keys on the Ducky One 2 Skyline, you must record a macro to bind the media function to a hotkey combination, i.e. Fn plus some key.

Example

Important: In the instructions below, "Press X+Y+Z" means press and hold key X, press and hold key Y, press and hold key Z in that order, and then release all three.

As an example, to bind Fn+PgUp to the play/pause media function:

  • Press Fn+2 to activate profile #2. Profile #1 (factory default) is not programmable. Indicator lights will flash twice.
  • Press and hold Fn+Ctrl for 3 seconds to start recording a macro. Indicator lights will flash slowly.
  • Press Fn+PgUp to define the Fn+PgUp hotkey combo. Indicator lights will flash quickly.
  • Press Fn+Win+D to bind the key combo to the play/pause function. Indicator lights will continue to flash quickly.
  • Press Fn+Ctrl to complete recording. Indicator lights will stop flashing.
  • The media key is now bound. Press Fn+PgUp to play/pause.

Resetting

To reset the current profile and clear all bindings, press and hold Win+Space for 3 seconds. The indicator lights will flash for a short while.

Media Key Legend

The following functions can be bound to hotkeys using the method above.

  • Fn+Win+A: Mute
  • Fn+Win+B: Volume Up
  • Fn+Win+C: Volume Down
  • Fn+Win+D: Play/Pause
  • Fn+Win+E: Stop
  • Fn+Win+F: Next Track
  • Fn+Win+G: Previous Track
  • Fn+Win+H: Calculator
  • Fn+Win+I: My Computer
  • Fn+Win+J: Browser
  • Fn+Win+K: Mail
  • Fn+Win+L: Multimedia
  • Fn+Win+M: Search
  • Fn+Win+N: Navigate Backwards
  • Fn+Win+O: Navigate Forwards
  • Fn+Win+P: Mouse Left Click
  • Fn+Win+Q: Mouse Right Click
  • Fn+Win+R: Mouse Middle Click
  • Fn+Win+S: Mouse Cursor Up
  • Fn+Win+T: Mouse Cursor Down
  • Fn+Win+U: Mouse Cursor Left
  • Fn+Win+V: Mouse Cursor Right
  • Fn+Win+W: Mouse Scroll Up
  • Fn+Win+X: Mouse Scroll Down
@smasetty

This comment has been minimized.

Copy link

@smasetty smasetty commented Mar 2, 2018

Thanks a lot for this helpful gist... :) I am using this keyboard with my Mac machine and looking for a way to swap the Windows and Alt buttons. I would like to change it on the keyboard and not in the MacOs. Have you tried this out? Thanks in Advance 👍

@schmich

This comment has been minimized.

Copy link
Owner Author

@schmich schmich commented Mar 16, 2018

@smasetty I didn't get a notification about your message, but yes, this is possible on the keyboard itself. The steps above work for any key-to-key remapping. In your case, the steps would be:

  1. Press Fn+<number> to activate whichever profile you want
  2. Press and hold Fn+Ctrl for 3 seconds to start recording
  3. Press and release a key to specify input (e.g. Alt)
  4. Press and release a key to specify output (e.g. Windows)
  5. Press Fn+Ctrl to complete recording

So, to swap Alt and Windows, you can follow the steps above once to remap Alt to Windows and a second time to remap Windows to Alt.

@imkk-000

This comment has been minimized.

Copy link

@imkk-000 imkk-000 commented Mar 23, 2018

The official manual book can't clear for me, but this helped to complete settings my keyboard. Thanks!

@valerius21

This comment has been minimized.

Copy link

@valerius21 valerius21 commented May 22, 2018

@smasetty you can use the dip switches on the backsite of your keyboard to archive this.

@andrej1459

This comment has been minimized.

Copy link

@andrej1459 andrej1459 commented Jul 23, 2018

this was very helpful however is there a way to unbind the calculator button, its really annoying as if you bind the play/pause button to the calculator it launches the calculator as well :/

@sgtlaggy

This comment has been minimized.

Copy link

@sgtlaggy sgtlaggy commented Aug 15, 2018

@schmich Similar to andrej's question, can you rebind the calculator button (or any other button/combo) to a key combination? Such as have the cal button bound to Ctrl+Alt+Num-, for example, and without having it launch the calculator?

EDIT: Bought a One 2. My purpose for this was mainly as a Toggle Mute keybind for Discord. Much easier to disable the calculator launch (add empty ShellExecute string in Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\AppKey\18) and just use the key as an extra bindable key.

As for binding key combinations, it seems to work, but has a significant delay. Binding a single key, even "special" keys like the Fn+Win combos), will create a direct binding with no delay.

@ievgenk

This comment has been minimized.

Copy link

@ievgenk ievgenk commented Sep 11, 2018

Thanks so much, just set up new ducky one two tkl :)

@Andyn3o

This comment has been minimized.

Copy link

@Andyn3o Andyn3o commented Oct 10, 2018

Does someone have the problem down when I set a combo key for volume up, I cant set the volume up continuously by holding it.
Eg:I can lower the volume from 100 to 0 by holding Fn + " [ " ( my combo) but i cant make it 0 to 100 by holding Fn + " ] "

@claco

This comment has been minimized.

Copy link

@claco claco commented Oct 14, 2018

Thanks for this guide! Made easy work of getting the music media keys on the keyboard for my MBP use.

@tangorri

This comment has been minimized.

Copy link

@tangorri tangorri commented Dec 13, 2018

Tanks I couldn't understand it from the manual ! Now I have a Fully functionnal Ducky !

@goobliata

This comment has been minimized.

Copy link

@goobliata goobliata commented Dec 13, 2018

I was thinking of getting one of these keyboards. Does the builtin mousekeys work on Linux/macOS? I think it's Fn+Num Lock to toggle it.

@christoshrousis

This comment has been minimized.

Copy link

@christoshrousis christoshrousis commented Jan 6, 2019

Is it just me, but when I try to do this I keep triggering the window 10 menu because you have to press windows key? is there an alternative method? It also triggers the mouse to move down everytime T_T

@AlexEshoo

This comment has been minimized.

Copy link

@AlexEshoo AlexEshoo commented Jan 11, 2019

@mikevb1 Thanks for the tip on the regedit change for the calculator I was able to change it to launch my preferred calculator on my windows 7 computer. (Windows 10 asks which you would like to use but 7 did not)

@Firewaters

This comment has been minimized.

Copy link

@Firewaters Firewaters commented Jan 18, 2019

Is is possible to do combo of ctrl + alt + <key>, or are they black listed keys.

@kwaazaar

This comment has been minimized.

Copy link

@kwaazaar kwaazaar commented Feb 21, 2019

Macros are played at the speed you typed them. This can be very frustrating for multiple-keys macros. However, you can change the playback speed for each key in your macro. Check out this article for more info:
https://hschne.at/2018/02/15/a-simple-guide-to-the-ducky-one.html#

@featalion

This comment has been minimized.

Copy link

@featalion featalion commented May 24, 2019

Is is possible to do combo of ctrl + alt + <key>, or are they black listed keys.

Have you found a solution or a workaround for that? I want to do a number of bindings for ctrl + <key>, but it seems impossible (at least if I follow steps from the user manual). At the same time I cannot find any restrictions for ctrl + <key>, ctrl + alt + <key>, etc. in the manual.

@kotfarepra

This comment has been minimized.

Copy link

@kotfarepra kotfarepra commented May 24, 2019

ORIGINAL QUESTION: How can I rebind the calculator key to open another program?

ANSWER :
Go to Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\AppKey\18 and change the calc.exe to whatever program you like to launch

@CaviaPorcellus

This comment has been minimized.

Copy link

@CaviaPorcellus CaviaPorcellus commented Aug 9, 2019

@goobliata This is a pretty late answer, but the built-in mouse movement and keys accessed via Fn+Num Lock work in Linux (in Ubuntu anyhow).

@goobliata

This comment has been minimized.

Copy link

@goobliata goobliata commented Aug 9, 2019

Thanks @aibraiduas. I got a different model Ducky keyboard like 8 months ago and never even checked it - I guess the mousekeys is not that important to me after all but glad to know it works.

@aaaleks

This comment has been minimized.

Copy link

@aaaleks aaaleks commented Aug 9, 2019

Hiiiii I just got a this keyboard and I'm having a hard time creating a macro. I want F1 to have the sequence "ADADADA" repeated and F3 to have a sequence that is just "space bar" over and over again. Is this possible? Can anyone help me with this? Thanks!

@G2G2G2G

This comment has been minimized.

Copy link

@G2G2G2G G2G2G2G commented Aug 17, 2019

Does someone have the problem down when I set a combo key for volume up, I cant set the volume up continuously by holding it.
Eg:I can lower the volume from 100 to 0 by holding Fn + " [ " ( my combo) but i cant make it 0 to 100 by holding Fn + " ] "

@Andyn3o doesn't seem possible because it's a macro key unfortunately.. I wish there was a way to remap the key not make it a macro, pretty terrible in most cases.

@G2G2G2G

This comment has been minimized.

Copy link

@G2G2G2G G2G2G2G commented Aug 17, 2019

Is it just me, but when I try to do this I keep triggering the window 10 menu because you have to press windows key? is there an alternative method? It also triggers the mouse to move down everytime T_T

@christoshrousis Yea you can press the windows key next to the FN seems to be the proper key to do the special characters, the left winkey is the wrong key for it. It seems to add a super+ special character if you do it that way (tested with XEV on linux)

I think you can press FN+2 before the actual macro is recorded and it forces your macro to NOT have a timer instead us e0.01ms in between keys or something. (should be added to the git)
Also this github works for all ducky 2 boards, it isn't specific to the skyline board.

@Gehbrial

This comment has been minimized.

Copy link

@Gehbrial Gehbrial commented Sep 10, 2019

I followed this guide and managed to set some custom media keys, but I'm forced to manually load profile #2 everytime I boot. Is there any way to automatically load it on startup? Thanks.

@Off1cal

This comment has been minimized.

Copy link

@Off1cal Off1cal commented Nov 1, 2019

hi this was very helpful, but i'm having little issues with resetting (win+space), it doesn't seem to reset it, it changes the languages

@tleb

This comment has been minimized.

Copy link

@tleb tleb commented Nov 5, 2019

Perfect, thank you.

One small thing: the key bindings provided for each media key is about the position, not the letter. For example, on an AZERTY keyboard, Mute and Mouse Right Click are swapped (Fn+Win+A and Fn+Win+Q).

@HeyBanditoz

This comment has been minimized.

Copy link

@HeyBanditoz HeyBanditoz commented Dec 31, 2019

Anyone else having an issue where after binding a play/pause key, the dedicated volume buttons cease to function? Sometimes they don't work at all, and other times they act as the play/pause button.

@tleb

This comment has been minimized.

Copy link

@tleb tleb commented Dec 31, 2019

I have an issue similar to this. I had mapped Play/Pause on a key but it doesn't work any more and I am not able to map it again. I tried resetting the keyboard but I'm not sure it was a full reset I did.

@KingsleyBawuah

This comment has been minimized.

Copy link

@KingsleyBawuah KingsleyBawuah commented Jan 11, 2020

Perfect. thanks!

@tuukkao

This comment has been minimized.

Copy link

@tuukkao tuukkao commented Jan 15, 2020

Thanks a million! The official manual is useless to me and I had no idea which keys were even possible to remap. I would have missed out on a lot if not for this gist.

@olitomas

This comment has been minimized.

Copy link

@olitomas olitomas commented Jan 28, 2020

I have a Ducky one 2 (DKON1808S). In my case I recorded the macros using the following key combinations:

FN + Ctrl for three seconds --> Enter macro mode

Press any key combination --> Set the key combination to record the macro for

Press key combination (for example FN + Win + A for Mute) --> Action to execute in the macro

FN + Alt --> End macro

FN + Ctrl for one second --> Exit macro mode

Found this method in this reddit thread:
https://www.reddit.com/r/MechanicalKeyboards/comments/a5egfb/ducky_one_2_mini_help_with_multimedia_keys/

@MDub329

This comment has been minimized.

Copy link

@MDub329 MDub329 commented Apr 9, 2020

I have a ducky one 2 TKL and the FN + Win + f/g will only pause my spotify. Any ideas to make it skip to next track?

@avogadro23

This comment has been minimized.

Copy link

@avogadro23 avogadro23 commented Apr 9, 2020

Great guide! Thank you!
Has anyone figured out how to program the media keys for Mac use? I have been searching and still not found the answer. So same question as @smasetty

@olitomas

This comment has been minimized.

Copy link

@olitomas olitomas commented Apr 9, 2020

@avogadro23 My instruction above worked on my Macbook pro. This worked for me witht the Ducky One connected to my Macbook pro (I mapped: pause (pause/play), page down (for next track) and page up (for previous track). Works like a charm!

@Jambrong1

This comment has been minimized.

Copy link

@Jambrong1 Jambrong1 commented Apr 11, 2020

i have a problem where my fn does not do the work
i did setting the dip switch but still not working
for example i use Fn+Win+C: Volume Down but not working

@avogadro23

This comment has been minimized.

Copy link

@avogadro23 avogadro23 commented Apr 11, 2020

Thank you @olitomas, I tried it out and works!

@ryanbarry33

This comment has been minimized.

Copy link

@ryanbarry33 ryanbarry33 commented Apr 15, 2020

I have programmed Fn+Home to pause, Fn+PgUp to next track, and Fn+PgDn to previous track. However, I am running into the problem of whenever I use these binds, it brings up my windows 10 menu. How do I make it so pressing my macros doesn't also bring up the windows 10 menu?

@MDub329

This comment has been minimized.

Copy link

@MDub329 MDub329 commented Apr 15, 2020

Anyone else having problems with these only pausing spotify? When I try and set next track prev track or mute it just pauses.

@tleb

This comment has been minimized.

Copy link

@tleb tleb commented Apr 18, 2020

My personal binding for volume and music is:

Key Control
Fn+Inser Volume Down
Fn+Orig Mute
Fn+PgUp Volume Up
Fn+Suppr Previous Track
Fn+Fin Play/Pause
Fn+PgDn Next Track

It makes two lines, one for volume control and one for music control which are easy to remember and I have no issues on Windows 10.

At one point I had an issue with the Play/Pause not working and I believe it started working again when I changed a DIP switch and changed it back later on. Not sure it is linked though.

@dcastro

This comment has been minimized.

Copy link

@dcastro dcastro commented Jun 2, 2020

Does someone have the problem down when I set a combo key for volume up, I cant set the volume up continuously by holding it.
Eg:I can lower the volume from 100 to 0 by holding Fn + " [ " ( my combo) but i cant make it 0 to 100 by holding Fn + " ] "

@Andyn3o @G2G2G2G I'm a bit late to the party, you two have probably already figured this out, for anyone new reading this:

After choosing the media key, you can (optionally) choose a "macro implemenation option" and a "macro record time option"

Screenshot from 2020-06-02 08-30-34
Screenshot from 2020-06-02 08-30-44

If you want to lower the volume from 100 to 0 by holding Fn + [, you have to choose the Fn+E implementation and the Fn+1 record time.

  1. Fn+Ctrl for 3 seconds (start recording macro)
  2. Fn+[
  3. Fn+Win+C (to bind volume down)
  4. Fn+E
  5. Fn+1
  6. Fn+Ctrl (end macro)

I think it's a good idea to use Fn+1 for most macros, to avoid delays between consecutive key presses. For example, to bind Fn+/ to mute, with no delay:

  1. Fn+Ctrl for 3 seconds (start recording macro)
  2. Fn+/
  3. Fn+Win+A (to bind mute)
  4. Fn+1
  5. Fn+Ctrl (end macro)
@akaeraser

This comment has been minimized.

Copy link

@akaeraser akaeraser commented Jun 15, 2020

I don't understand. What if I just want it that if I press the letter e it spams e and then enter multiple times and then left clicks in as short of a time as possible. And I only want to press the button once for it to complete the function many times. How would I do that? And is there a character limit for how many keys are pressed?

@stelios313

This comment has been minimized.

Copy link

@stelios313 stelios313 commented Oct 1, 2020

This does not work for me on Linux.
Was working perfectly on MBP though.

@G2G2G2G

This comment has been minimized.

Copy link

@G2G2G2G G2G2G2G commented Oct 2, 2020

OS isn't relevant, will work on everything since it's the keyboard's controller.

@tleb

This comment has been minimized.

Copy link

@tleb tleb commented Oct 2, 2020

I once had a similar issue. Not sure what fixed it, I toggled the DIP switches a few time (the final value was the same as the initial one — all zero) and it started working again.

@niklaspeura

This comment has been minimized.

Copy link

@niklaspeura niklaspeura commented Oct 2, 2020

Thanks, just got my Ducky one 2 and this helped me understand how to configure the keys 👍

@leaveme

This comment has been minimized.

Copy link

@leaveme leaveme commented Oct 13, 2020

Thanks, this was very helpful, it works like a charm.

@mariusrueve

This comment has been minimized.

Copy link

@mariusrueve mariusrueve commented Nov 17, 2020

What does "Multimedia" mean?

@G2G2G2G

This comment has been minimized.

Copy link

@G2G2G2G G2G2G2G commented Nov 17, 2020

@mariusrueve dude you have the entire internet and you choose to ask here?

@mariusrueve

This comment has been minimized.

Copy link

@mariusrueve mariusrueve commented Nov 18, 2020

What does "Multimedia" mean?

Multimedia will open your default music player.

@stefangreim

This comment has been minimized.

Copy link

@stefangreim stefangreim commented Nov 19, 2020

Is there a way to mute/unmute my microphone? At least in Windows, but if possible in linux too. My notebook has a special key for this but I cannot figure out how this works...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.