duckyPad-Pro

duckyPad Software macOS / Linux Notes

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:
- Configurator
- Profile Autoswitcher
Double click to unzip
Right Click on the folder, select New Terminal at Folder

The right click menu with the option "New Terminal at Folder" higlighted.

Type sh ./run.sh, press enter.

The text to run the configurator shown in a terminal window.

Type your password.
- The letters won’t appear, but press enter and it should launch!

[!IMPORTANT] Use this to start the app every time, it grants the configurator permission to connect to the duckyPad.

If macOS complains about unsigned app

Warning pop-up with the text: "duckypad_config cannot be opened because it is from an unidentified developer. macOS cannot verify that this app is free from malware."

Go to Settings > Privacy & Security
Scroll down to security section and click “Allow Anyway”

Settings screen in Privacy & Security, the warning "‘duckypad_config’ was blocked from use because it is not from an identified developer," is shown above a button with the text "Allow Anyway".

If the configurator complains about needing additional permissions:

Error pop-up with the text "duckypad detected, but I need additional permissions" and three options: Yes, No, and Cancel.

Try granting Input Monitoring and Full Disk Access permissions for the Terminal app.

Input Monitoring settings granted to the Terminal and configurator app

If everything else fails, you can edit manually by entering USB mount mode (hold +, select Mount USB) and selecting the newly appeared SD card.

macOS: Run from Source

Download the latest source:
- Configurator
- Profile Autoswitcher
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
- Configurator: sudo python3 ./duckypad_config.py
- Autoswitcher: sudo python3 ./duckypad_autoprofile.py

Linux

You can run the code from source under Linux.

Download the latest source:
- Configurator
- Profile Autoswitcher
Unzip & open terminal at the directory
Install tkinter and pip3: sudo apt install python3-tk python3-pip
Install dependencies: sudo pip3 install -r requirements.txt
Launch the app
- Configurator: sudo DUCKYPAD_UI_SCALE=1 python3 ./duckypad_config.py
- Autoswitcher: sudo DUCKYPAD_UI_SCALE=1 python3 ./duckypad_autoprofile.py
For High-DPI screens, adjust DUCKYPAD_UI_SCALE to suit.

Use Without `sudo`

Create the udev rule file: sudo touch /etc/udev/rules.d/41-duckypad.rules
Add following contents:

SUBSYSTEM=="usb" ATTRS{idVendor}=="0483", ATTRS{idProduct}=="d11d", MODE="0660", TAG+="uaccess", TAG+="udev-acl", TAG+="DuckyPad Pro"
SUBSYSTEM=="usb" ATTRS{idVendor}=="0483", ATTRS{idProduct}=="d11c", MODE="0660", TAG+="uaccess", TAG+="udev-acl", TAG+="DuckyPad"
KERNEL=="hidraw*", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="d11d", MODE="0660", GROUP="plugdev", TAG+="uaccess", TAG+="udev-acl", TAG+="DuckyPad Pro"
KERNEL=="hidraw*", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="d11c", MODE="0660", GROUP="plugdev", TAG+="uaccess", TAG+="udev-acl", TAG+="DuckyPad"

Set permissions: sudo chmod 644 /etc/udev/rules.d/41-duckypad.rules
Set ownership: sudo chown root:root /etc/udev/rules.d/41-duckypad.rules
Reload udev rules: sudo udevadm control --reload-rules
Trigger udev: sudo udevadm trigger
Unplug & replug duckyPad