Skip to content

dekuNukem/duckyPad

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,270 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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 for power users who demand advanced macro scripting and customisation beyond the shackles of QMK/VIA.

Alt text

Using a turing-complete scripting language, you can automate any keyboard/mouse input you want, from simple combos to full-blown programs.

Get One

duckyPad was successfully funded on Kickstarter thanks to the amazing backers!

Highlights

duckyPad has all the basics:

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

But also unique features not seen anywhere else:

  • Custom duckyScript engine, NOT QMK/VIA.
  • Longer and more complex macros
  • OLED screen
  • 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

duckyScript vs QMK/VIA

duckyPad uses duckyScript, originally designed for USB Rubber Ducky.

Compared to QMK/VIA, you get:

  • Much Longer Macros

  • Turing-Complete Scripting

    • Variables, conditions, loops, functions, and more.
    • Executed on 32-bit Bytecode VM
    • With Scratch and Non-volatile Memory
  • Advanced Interactions

    • Reading Buttons
    • Print to OLED screen
    • Change RGB Color
  • SD Card Storage

    • Fast Configuration / Backup / Deployment
    • No sketchy drivers or apps
    • No recompiling

While QMK/VIA are great for regular keyboards, they are rather limited at input automations.

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

🆕 duckyPad Pro

duckyPad Pro is an updated model with:

  • Rotary Encoders
  • More Keys
  • Bluetooth
  • Bigger Display
  • More Script Storage
  • Expansion Module

👉👉👉 Purchase Link | More Info

Alt text

Discord Community

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

How It Works / Showcase

  • Create up to 32 profiles, one for each application.

  • Assign up to 15 keys per profile

  • Names are shown on OLED screen

  • Write a duckyScript for each key

Easy Start

  • duckyScript is a language for automating inputs

    • At simplest, you just tell it what key to press!
  • Such as key combos of your favorite app

CTRL a , CTRL +, etc.

Alt text

Up a Notch

  • Once familiar, you can write longer multi-line macros to further speed up everyday task.

  • Such as filling forms and typing boilerplate text with one keypress.

STRING Michael Scott
TAB
STRING United States
ENTER
STRING 5705550100
TAB
STRING michael.scott@dundermifflin.com
TAB

Alt text

Or a simple mouse jiggler:

WHILE TRUE
	MOUSE_MOVE $_RANDOM_INT $_RANDOM_INT
	DELAY 100
END_WHILE

alt_text

Full Potential

  • Going all-out, duckyScript is a Turing-Complete general-purpose language.
  • You can use it to:
    • Read Buttons
    • Write to OLED screen
    • Change RGB colors
    • Perform operations with 32-bit variables, conditions, loops, function calls, and more!
  • Write ultra-specific macros for your exact needs
RGB_SET 1 128 0 255

OLED_PRINT You are in a maze
OLED_PRINT of twisty little passages

VAR choice = _READKEY

IF choice == 1
    OLED_CURSOR 0 10
    OLED_PRINT It is a dead end.
    OLED_PRINT Something moves
    OLED_PRINT behind you.
END_IF

alt_text

Hackerman

  • Of course, by automating HID inputs, you can take over an entire computer with the push of a button!

alt_text


Nothing Like It

  • From simple shortcuts to full-blown programs, duckyScript can easily achieve what was impossible on QMK/VIA.

  • Each macro can contain over 50,000 characters

  • Store 480 macros in total

  • Executed on custom virtual stack machine

Features

Switches & Keycaps

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

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

Alt text

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.

Per-key RGB backlight

Each key on duckyPad has its own RGB backlight. User-configurable colour & brightness.

OLED screen

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

  • 128x128
  • 1.3 inch
  • High contrast with true black
  • Burn-in Prevention

Alt text

Companion App

Use the open-source configurator to set up your duckyPad Pro.

  • Windows | Mac | Linux
  • No account / subscription needed
  • No data collection / telemetry

Alt text

Profile Auto-switching

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.

Getting Started

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

I Want One!

duckyPad is now available on Tindie.

Also consider joining our discord for latest updates and discussions.

Table of Contents

Main page

Getting Started Guide

Kit Assembly Guide

Using duckyScript

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.