# duckyPad Firmware Updates and Version History

[Get duckyPad](https://dekunukem.github.io/duckyPad-Pro/doc/landing.html) | [Official Discord](https://discord.gg/4sJCBx5) | [Getting Started](getting_started.md) | [Table of Contents](#table-of-contents)

-----

## Latest Firmware

### v3.0.4

15 Mar 2026

* 🐞 Increased Anykey-to-Abort Check Frequency
* 🆕 **"Turing Complete" Mega-update**
	* 👉 [**Full Details**](https://dekunukem.github.io/duckyPad-Pro/doc/beta_test.html)

----------

👇👇👇👇👇👇👇👇👇👇

* [Download Firmware](https://github.com/dekuNukem/duckyPad/raw/master/firmware/duckypad_v3.0.4.dfu)

☝️☝️☝️☝️☝️☝️☝️☝️☝️☝️☝️

## USB Firmware Update

### Enter DFU Mode

Locate the **`DFU`** button:

![Alt text](resources/pics/dfu_buttons_new.jpg)

* Make sure duckyPad is unplugged.

* **`Hold down DFU button`** while plugging it into a computer.

* Once plugged in, you can release the button.

If it went well, **the backlight and display should stay off**.

### Windows

Download and install the [STM32 DfuSe tool](resources/en.stsw-stm32080_stm32_DfuSe.zip) from this repo.

(Also available from [official website](https://www.st.com/en/development-tools/stsw-stm32080.html), but requires account sign-up.)

Launch `DfuSeDemo`:

![Alt text](resources/pics/dfu_start.png)

In `Available DFU Devices`, you should see a `STM Device in DFU Mode`.

![Alt text](resources/pics/dfu_available.png)

* **⚠️ If nothing shows up**, you might need to install a driver.

	* [Click me for details](https://github.com/dekuNukem/daytripper/blob/master/dfu_driver_install.md)

* Press `Choose...` button

* Select the firmware file you just downloaded. Shoud be in `.dfu` format .

![Alt text](resources/pics/dfu_choose.png)

Press `Upgrade` button to start uploading.

![Alt text](resources/pics/dfu_upgrade2.png)

**It should only take a few seconds!** **`Try using a USB hub`** if it is particularly slow.

![Alt text](resources/pics/dfu_uploading2.png)

After completion, press **`RESET`** button (or power-cycle) to start using the new firmware. 

### macOS / Linux

Using terminal, install [dfu-util](http://dfu-util.sourceforge.net/) with a package manager. For macOS you can use [Brew](https://brew.sh/):

`brew install dfu-util`

Hold DFU button and connect duckyPad, then run:

`dfu-util --device ,0483:df11 -a 0 -D /path/to/duckypad_firmware.dfu`

After completion, press **`RESET`** button (or power-cycle) to start using the new firmware. 

---------------------

## Firmware Version History

### v3.0.3 (5 Mar 2026)

* 🐞 Fixed `GOTO_PROFILE` not working

### v3.0.2 (Feb 9 2026)

* 🆕 **"Turing Complete" Mega-update**
	* **32-bit** Overhaul
	* Proper **Function Calls**
	* **Print Format** Specifiers
	* **Horizontal** Mouse Scrolling
	* **New Commands**, Bug Fixes, and much more!
* 👉 [**Full Details & Changelog**](https://dekunukem.github.io/duckyPad-Pro/doc/beta_test.html)

### 2.3.2 (July 9 2025)

🆕 Increased Persistent Global Variable count to 32

🆕 Added support for **reading and writing PGVs from a computer**. [Details](https://github.com/duckyPad/duckyPad-Profile-Autoswitcher/blob/master/HID_details.md)

🐞 Fixed a bug that caused PGVs to not work

🐞 Fixed a bug where HID buffer was not properly cleared causing ghost inputs

🐞 Fixed a bug that increased chance of SD card corruption

### 2.1.0 (May 24 2025)

🆕 Reduced latency by caching recent keypresses

⚠️ Make sure to use the [Latest Configurator](https://github.com/duckyPad/duckyPad-Configurator/releases/latest)

### 2.0.0 (Apr 7 2025)

🆕 Backported **all new firmware features/improvements** from [duckyPad Pro](https://dekunukem.github.io/duckyPad-Pro/) to OG duckyPad (2020)!

🆕 Unified Configurator that works with BOTH models

🆕 Improved data transfer protocol that reduces read/write time

⚠️ Make sure to **load & save** with the [Latest Configurator](https://github.com/duckyPad/duckyPad-Configurator/releases/latest)

⚠️ `EMUK` command has been deprecated, use `KEYDOWN` and `KEYUP` in `on_press` and `on_release` panels.

### 1.3.3 (Dec 2 2024)

🐞 Fixed a bug where RGB brightness gets dimmer after reloading

🐞 Fixed a bug where `MOUSE_WHEEL` command can be unresponsive

### 1.3.0 (July 2 2023)

🆕 Added `_TIME_S` reserved variable

🐞 Fixed laggy `EMUK`

🐞 Fixed `EMUK` n-key rollover not working

🐞 Fixed crashing when changing profile under certain circumstances

### 1.2.0 (May 3 2023)

🆕 **duckyScript 3** support! 

🆕 Variables, IF statements, WHILE loops, functions, and more.

🆕 Print to OLED screen

🆕 Read button status

🆕 Improved performance

🐞 Assorted bug fixes

💭 As usual, [Let me know](#questions-or-comments) if you encounter any issues.

### 0.21.0 (Nov 23 2022)

🆕 Renamed `HOLD` to `EMUK` for compatibility with duckyScript 3

🆕 Added Japanese input mode keys

🆕 Added JIS keymap

🐞 Minor bug fixes

### 0.20.2 (Oct 28 2022)

🆕 Added `STRINGLN` command. Same as `STRING` but presses enter key at the end.

🐞 Fixed a bug that causes unresponsive keys.

### 0.20.1 (Jul 21 2022)

🆕 `LOOP` state and RGB LED color is now persistent across profile switches and reboots!

🆕 Added `LCR` command to reset loop counter.

🆕 Shortened profile switching animation even more!

### 0.19.8 (Dec 23 2021)

🆕 Shortened profile switching animation, feels much more snappy now!

🆕 Added sleep status byte in [HID info packet](https://github.com/dekuNukem/duckyPad-profile-autoswitcher/blob/master/HID_details.md#info-0x00).

🆕 Added a [new HID command](https://github.com/dekuNukem/duckyPad-profile-autoswitcher/blob/master/HID_details.md#sleep-0x15) to put duckyPad to sleep

🐞 Fixed a configuration error that prevented F13-F24 keys from working under Linux.

### 0.19.1

🆕 Configure duckyPad via USB **WITHOUT taking out SD card!** [Click me for details.](https://github.com/dekuNukem/duckyPad/blob/master/getting_started.md#using-duckypad-configurator)

🆕 Added `KEYUP` and `KEYDOWN` commands for holding keys

### 0.18.0

🆕 **Mouse support!** [Click me for details.](https://github.com/dekuNukem/duckyPad/blob/master/duckyscript_info.md#mouse-buttons)

🆕 **Profile auto-switching** support! [Switch profiles automatically](https://github.com/dekuNukem/duckyPad-profile-autoswitcher) based on currently active window!

🆕 [Two-way HID communication](https://github.com/dekuNukem/duckyPad-profile-autoswitcher/blob/master/HID_details.md) support! Write your own software to control duckyPad!

### 0.17.0

* `LOOP` counter will no longer reset during sleep.

* Key colour changes will also now persist through sleep.

* `MENU` key now works properly.

### 0.16.0

* Added `COMMAND` and `OPTION` aliases for macOS. 

* Added support for right-side modifier keys, such as `RCTRL`, `RSHFIT`, `RALT`, etc.

* [Click me](https://github.com/dekuNukem/duckyPad/blob/master/duckyscript_info.md#special-keys) to learn more.

### 0.15.0

* Added `DP_SLEEP` command to make duckyPad to go sleep.

* Added `PREV_PROFILE`, `NEXT_PROFILE`, and `GOTO_PROFILE` commands for profile switching.

* Fixed a bug, `F13 - F24` keys should work properly now.

### 0.14.0

* Added attributions and metadata in keymap files, updated firmware to handle them.

* Added support for cedilla deadkey in keymaps.

### 0.13.0

* Added `SWCOLOR` command to change the colour of a key inside a script.

* Read about its usage [here](https://github.com/dekuNukem/duckyPad/blob/master/duckyscript_info.md#swcolor-experimental).

### 0.12.1

* Fixed an issue of key sticking with `HOLD` command.

### 0.12.0

* Added an **experimental** `LOOP` command, allowing cycling through different actions on the same key.

* Read about its usage [here](https://github.com/dekuNukem/duckyPad/blob/master/duckyscript_info.md#loop-experimental).

### 0.11.3

* Fixed a bug that prevented `HOLD` command from working on the very first press.

### 0.11.2

* Fixed a bug in keymap parser to allow `SHIFT` and `AltGr` to be pressed simultaneously.

### 0.11.1

* Increased maximum simultaneous key presses to 6.

* Now you can type [alt codes](resources/altcodes.pdf) like `ALT KP_0 KP_1 KP_9 KP_7`.

* Using duckyPad as a WASD gamepad with [`HOLD` command](https://github.com/dekuNukem/duckyPad/blob/master/duckyscript_info.md#hold-experimental) becomes more viable too.

### 0.11.0

🆕 Added keymap file support for multiple keyboard layouts.

* Instead of hard-coded keyboard layouts, you can now download up to 8 keymap files to the SD card and use them on duckyPad.

* See [the updated guide](https://github.com/dekuNukem/duckyPad/blob/master/getting_started.md#using-the-duckypad-configurator) about loading keymaps to your duckyPad.

* See [this guide](https://github.com/dekuNukem/duckyPad/blob/master/keymap_instructions.md) about making your own keymaps.

🆕 Added extended ASCII character support.

* Now `STRING` command can type out characters like `§²µ¤³°ß` if they exist on the current keyboard layout.

🆕 Added support for dead keys.

* `STRING` command can now also use dead keys to type out characters with accents such as `òóôõö`.

🆕 Added German keyboard layout.

🆕 Added `F13` to `F24` keys.

🆕 Added `POWER` key.

### 0.10.0

* Improved `HOLD` command performance

### 0.9.0

* Added profile quickswitching

* **`Hold down`** `+` button and jump between profiles

### 0.8.0

* Added `HOLD` command, where duckyPad will hold a key when you press it, and release only when you release it.

* See [this guide](https://github.com/dekuNukem/duckyPad/blob/master/duckyscript_info.md) for details. 

* This command makes it behave more like a traditional keyboard.

* You can use this command to turn duckyPad into a WASD game pad for example.

* Adjusted configuration file structure. You might need to set your keyboard layout again.

### 0.7.0

* Added support for numpad keys. See [this guide](https://github.com/dekuNukem/duckyPad/blob/master/duckyscript_info.md) for details. 

### 0.6.0

* Added support for `AZERTY (French)`, `AZERTY (Belgium)`, and `Dvorak` layout.

* **`HOLD DOWN TOP LEFT KEY`** while **`PLUGGING IT IN`** to switch layouts.

* Some behind-the-scene optimisation

### 0.5.0

* Added RGB LED brightness adjustment

* Hold down +/- button to change brightness

### 0.4.0

* Added support media keys (volume up/down, play/pause, mute, prev/next track, etc)

* [More details](duckyscript_info.md).

### 0.3.0

* Added support for `MENU` key (the 'right click' key on windows keyboard that no one uses).

* Increased max number of profiles to 32.

### 0.2.1

* duckyPad now store its firmware version on SD card, so PC app can check for updates.

### 0.2.0

Major update. New features and optimisations.

* You can now use symbols like `?*<>/\` in key names.

* Significantly increased profile switching speed.

* Added sleep mode. Your duckyPad can now turn off after a configurable delay. Press any key to wake it up.

* Other minor fixes

### 0.1.0

Initial Release

## Table of Contents

[Main page](README.md)

[Getting Started Guide](getting_started.md)

[Kit Assembly Guide](kit_assembly_guide.md)

[Using duckyScript](https://dekunukem.github.io/duckyPad-Pro/doc/duckyscript_info.html)

[Common issues / Troubleshooting](troubleshooting.md)

[Firmware Updates and Version History](firmware_updates_and_version_history.md)

[Make Your Own Keymap](./keymap_instructions.md)

[Build a duckyPad Yourself](build_it_yourself.md)

[Kickstarter Backer Acknowledgments](kickstarter_backers.md)

## Questions or Comments?

Please feel free to [open an issue](https://github.com/dekuNukem/duckypad/issues), ask in the [official duckyPad discord](https://discord.gg/4sJCBx5), DM me on discord `dekuNukem#6998`, or email `dekuNukem`@`gmail`.`com` for inquires.