Skip to content

dekuNukem/duckyPad

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

duckyPad: Do-It-All Mechanical Macropad

Get duckyPad | Official Discord | Getting Started | Table of Contents


duckyPad is a 15-key mechanical macropad that helps consolidate and speed up workflow by automating keyboard/mouse inputs using duckyScript.

Alt text

It has all the basics:

  • Hot-swap
  • Per-key RGB
  • USB-C
  • Fully open-source

But also unique features not seen anywhere else:

  • Configurable OLED screen
  • Custom duckyScript engine, NOT QMK/VIA.
  • Much longer and sophisticated macros
  • 32 profiles of 15 keys, 480 macros total.
  • Automatic profile switching based on active window.
  • microSD storage, move between devices with ease.
  • No proprietary drivers, works out-of-box.

Alt text

The macros can be as simple as Ctrl + C, or as complex as filling forms, launching applications, or even creating root backdoors or grabbing passwords. It's all up to you!

duckyScript vs QMK/VIA

duckyPad uses duckyScript, of USB Rubber Ducky fame.

Compared to QMK/VIA, you get:

  • Much Longer Macros

  • Sophisticated Interactive Scripting

    • Variables, IF statements, loops, functions, etc.
    • Reading Buttons
    • Print to OLED screen
    • Change RGB Color
    • Fine timing control
    • Randomization
  • Local Storage

    • Everything stored on SD card
    • Quick configuration / Backup / Duplication
    • No sketchy drivers or apps
  • Existing Resources

While QMK/VIA are great for regular keyboards, they are rather hopeless at even the basics of input automations.

duckyScript is a no-brainer for power users with more demanding scripting needs.

Get duckyPad

duckyPad is now available on Tindie!

And thanks to the interest and support from the amazing people like you, the Kickstarter campaign has been a great success!

Discord Community

Feel free to join our Official Discord for discussions, questions, sharing scripts, and latest updates!

Showcase

By automating frequently-used actions, you can streamline and speed up your daily routine.

A few examples:

Launching Applications

Open your favorite app with the press of a button:

Alt text

Managing Livestreams

Switch scenes, start/stop stream, start/stop recording, play ads, and a lot more!

Alt text

Security Research

By automating keystrokes, you can take over an entire computer with the push of a button.

This is known as BadUSB attack, and was the original purpose of USB Rubber Ducky.

But of course, it's up to you to decide what to do!

Alt text

Photoshop / CAD

Put all your shortcuts in one place, makes things faster:

Alt text

One-finger Twitch Chat

no need to explain this one

Alt text

Switching Profiles

With all the potential usages, duckyPad supports up to 32 profiles.

Simply press the +/- button to switch between them, or use the profile autoswitcher to switch automatically based on current active window.

Alt text

... and more!

Those are just some examples! You can use duckyPad to do whatever you want!

Features

Mechanical Switches

duckyPad is compatible with Cherry MX-style mechanical switches (3 or 5-pin).

duckyPad comes with Gateron Green or Kalih BOX Navy switches, both of which are firm and clicky.

Of course, you can also install your own!

Keycaps

By default, duckyPad comes with blank translucent ABS R4 keycaps:

Alt text

Again, you can use your own as well.

Hot-swap Sockets

duckyPad supports hot-swapping with Kailh sockets.

You can install/remove the switches by hand, no soldering needed.

Alt text

Per-key RGB backlight

Each key on duckyPad has its own RGB backlight. You can assign unique colours to suit your needs.

OLED screen

duckyPad has an OLED screen. It displays current profile and key names, so you know what each key does at a glance.

  • 1.3-inch blue OLED display
  • High contrast with true OLED black
  • 128 x 64 resolution
  • Burn-in prevention

Alt text

duckyScript

duckyPad uses duckyScript for keyboard automation.

It is powerful, but also easy and straightforward to write.

A simple example look like this:

CONTROL SHIFT ESC

When you press a key, it will bring up the Task Manager, no need for memorising the 3-key combo.

Alt text

Of course, it can do much more!

A multi-line example that open up notepad, types "Hello world", and increases text size:

WINDOWS R
DELAY 400
STRING notepad
ENTER
DELAY 400

STRING Hello World!
CONTROL +
REPEAT 10

Alt text

See the full guide here.

Companion App

duckyPad comes with a companion app for Windows 10, macOS, and Linux. You can use it to:

  • Manage profiles
  • Manage key name, color, and arrangements.
  • Write and debug duckyScript.
  • Change, save, and backup configurations.

Alt text

But more importantly, duckyPad app respects your privacy:

  • Fully open-source
  • No need to create an account
  • No data collection whatsoever
  • No internet connection required
  • You don't even have to use it! You can set up your duckyPad manually.

USB-C and Device Compatibility

duckyPad uses USB-C connector for maximum device compatibility.

Alt text

You can use duckyPad out-of-box on pretty much anything that supports USB keyboards, no driver needed. Examples include:

  • PC
  • Mac
  • Linux
  • Raspberry Pi
  • iPhone / iPad
  • Android phones and tablets
  • Chromebooks
  • Game consoles

duckyPad’s firmware can also be easily updated via USB-C for new features and bug fixes.

Keyboard Layouts

duckyPad supports multiple keyboard layouts:

  • English (US)
  • English (UK)
  • French
  • Belgium
  • German
  • Dvorak
  • ...and more user-created layouts!

Dimensions

Click me for vector files of front and back plates.

Click me for dimensions drawings.

I want one!

duckyPad is now available on Tindie.

Also consider joining our discord for latest updates and discussions.

Press Kit / More Photos

Click me to download some high-resolution photos of duckyPad, feel free to share them.

Getting started

Please see the instruction manual on how to use your duckyPad.

Making one yourself

Please see this guide.

Derivatives

A number of projects are based on duckyPad, they are listed here!

  • simonCor ported this project to a STM32F4 black pill, with hand-soldered connections and 3D-printed case, very neat!

  • headslash is working on Frankenduck, with redesigned PCB, 3D-printed case, and extra switches.

Table of Contents

Main page

Getting Started Guide

Kit Assembly Guide

Using duckyScript | duckyScript 3 Info

Common issues / Troubleshooting

Firmware Updates and Version History

Make Your Own Keymap

Build a duckyPad Yourself

Kickstarter Backer Acknowledgments

Questions or Comments?

Please feel free to open an issue, ask in the official duckyPad discord, DM me on discord dekuNukem#6998, or email dekuNukem@gmail.com for inquires.