Skip to content

Latest commit

 

History

History
185 lines (97 loc) · 5.38 KB

troubleshooting.md

File metadata and controls

185 lines (97 loc) · 5.38 KB
Raw

Common Issues / Troubleshooting

Support on Kickstarter! | Official Discord | Getting Started | Table of Contents

Some commonly encountered issues are explained here.

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:

Alt text

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!

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:

Alt text

  • Copy all the files back.

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

Alt text

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

Alt text

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

Alt text

  • Select Screen Recording, and repeat the same process

Alt text

Launch app as administrator

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

  • Tick New Terminal at Folder

Alt text

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

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

Alt text

  • 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!