duckyPad-Pro

duckyPad Configurator macOS / Linux Notes

Get duckyPad Pro

Official Discord

Getting Started

Table of Contents

---

macOS

On macOS, you can run the configurator as a pre-packaged app, or execute the source code directly.

macOS Pre-packaged App

• Download the latest macOS release here

• Double click to unzip

• Right Click on the folder, select New Terminal at Folder

• Type sh ./run.sh, press enter.

• Authenticate. Your password will be hidden in the terminal, the letters won’t appear but press enter and the configurator should launch!

[!IMPORTANT] You should use this to start the application every time, it grants the configurator permission to connect to the duckypad.

---

• If macOS complains about unsigned app

• Go to Settings > Privacy & Security

• Scroll down to security section and click “Allow Anyway”

---

If the configurator complains about needing additional permissions:

• Try granting “Input Monitoring” permissions for the Terminal app.

  

  

• If still not working, try “Full Disk Access” or “Developer Tools”.

• If everything fails, you can also edit your duckypad by manually entering USB mount mode (hold +, select key 6) and selecting the newly mounted SD card. Be careful, this will fail to properly eject the SD card before restarting the duckypad which may corrupt it, and macOS will complain about this.

macOS Run from Source

• Download the latest source release here
• Double click to unzip
• Right Click on the folder, select New Terminal at Folder

---

• Use homebrew to install python-tk: brew install python-tk
• [Optional] Make a virtualenv and activate it: python3 -m venv .venv; source .venv/bin/activate
• Install dependencies: pip3 install -r requirements.txt
• Launch the app: sudo python3 ./duckypad_config.py

---

Linux

You can run the code from source under Linux.

Download the latest source release here

• Unzip & open a terminal at the directory
• Install tkinter: sudo apt install python3-tk
• Install dependencies: sudo pip3 install -r requirements.txt
• Launch the app: sudo DUCKYPAD_UI_SCALE=1 python3 ./duckypad_config.py
  • For High-DPI screens, adjust DUCKYPAD_UI_SCALE environment variable.
• Setup the udev rules
  • Create the file: sudo touch /etc/udev/rules.d/20-duckyPad.rules
  • Add the following contents: ``` SUBSYSTEMS==”usb”, ATTRS{idVendor}==”0483”, ATTRS{idProduct}==”d11c”, TAG+=”uaccess”, TAG+=”udev-acl” SUBSYSTEMS==”usb”, ATTRS{idVendor}==”0483”, ATTRS{idProduct}==”d11d”, TAG+=”uaccess”, TAG+=”udev-acl”
  • Give it the correct permissions: sudo chmod 644 /etc/udev/rules.d/20-duckyPad.rules
  • Give it the correct ownership: sudo chown root:root /etc/udev/rules.d/20-duckyPad.rules
  • Reload udev rules: sudo udevadm control --reload-rules
  • Trigger udev: sudo udevadm trigger

This site is open source. Improve this page.