duckyPad-Pro

Common Issues / Troubleshooting

Get duckyPad Pro

Official Discord

Getting Started

Table of Contents

---

Some commonly encountered issues are explained here.

• I press a key and nothing happens!
• Letters and symbols come out wrong!
• My script behaves inconsistently!
• I want to use my own SD card!
• The RGB backlight is flickering slightly!
• The RGB backlight is too bright!
• Will OLED suffer burn-in?
• Numpad keys doesn’t work!
• USB configuration / Autoswitcher isn’t working on macOS!

Join Our Discord!

If you have issues not in this list, feel free to join our Official Discord to ask about it! We also have discussions, script sharing, and latest updates!

---

I press a key and nothing happens!

First of all, make sure the key has a script mapped to it.

If in doubt, use one of the sample profiles.

Just updated firmware?

Use the latest configurator, press Connect to load up data, then press Save to write it back.

If none of the keys work

• Check that the cable is plugged all the way in.

• Try a different cable.

• Try a different USB port.

• Try using a USB hub.

• Try a different computer.

If a certain key doesn’t work

Take off the switch and inspect the pins, chances are one of them is bent:

Straighten it up with a pair of pliers, then insert again.

Make sure the pins are straight and aim for hot-swap socket holes.

Letters and symbols come out wrong!

• Long-press +/- button.

• Select the correct keyboard layout.

• Read more about writing your own keymaps.

My script behaves inconsistently!

duckyPad might be typing too fast for your computer.

Slow it down with the following commands:

• DELAY n adds an arbitrary delay in milliseconds.

• DEFAULTDELAY n sets how long to wait between each line of code.

• DEFAULTCHARDELAY n sets how long to wait between each keystroke.

• Default is 20ms, try 50 if too fast. Set it at the very beginning of script.

I want to use my own SD card!

• (Optional) Copy off existing files of old SD card.

• Format the new SD card in FAT or FAT32:

• Copy all the files back.

• You can also download the sample profiles and copy everything to the root of your SD card:

The RGB backlight is flickering slightly!

• Make sure the USB port can provide enough power

• Use a high-quality cable

The RGB backlight is too bright!

• Adjust the brightness by long-pressing +/- button.

Will OLED suffer burn-in?

Measures have been taken to prevent burn-in.

• Screen dims after 1 minute.

• duckyPad goes to sleep after 5 minutes (adjustable).

Numpad keys doesn’t work!

Make sure NUMLOCK is on.

USB configuration / Autoswitcher isn’t working on macOS!

Due to the security restrictions of macOS, to use USB configuration and autoswitcher, you need to:

• Enable “Input Monitoring” permission (for loading from USB)

• Enable “Screen Recording” permission (for reading window titles)

• Run the app as root

Enable permission

• Open System Preferences -> Security & Privacy

• Select Input Monitoring

• Click the lock to make changes

• Press the + button

• Go to Applications -> Utilities, and add Terminal to the list.

• Select Screen Recording, and repeat the same process

Launch app as administrator

• Open System Preferences -> Keyboard -> Shortcuts -> Services

• Tick New Terminal at Folder

• Download the latest macOS software, unzip into a folder.

• Right click on the unzipped folder and select New Terminal at Folder

• Type in sh run.sh and press enter, then enter your password.

• The app should launch as administrator, and should be fully functional now.

• If it still doesn’t work, let me know!

Table of Contents

Main page

Getting Started Guide

Kit Assembly Guide

Using duckyScript

duckyScript VM

Tinkering Guide

Troubleshooting

Firmware Update

Questions or Comments?

Please feel free to open an issue, ask in the official duckyPad discord, or email dekuNukem@gmail.com!

This site is open source. Improve this page.