Skip to the content
4 layers52.3 × 25.3 mmHackducky, the printed circuit board in 3D

Our board is powered by the reliable Raspberry Pi RP2040 microcontroller and includes 16 MB of flash storage, giving plenty of room for scripts and firmware.

Size
52.3 × 25.3 mm
Copper layers
4
Thickness
1.6 mm
Parts
83
Nets
70
Pads
248
Tracks, vias
773, 198
Pours
5
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
6 Apr 2025
Updated
12 Mar 2026

Overview

Hackducky is an open-source printed circuit board by souptik-samanta, from the souptik-samanta/Hackducky repository on GitHub. It is a 4-layer board of 52.3 × 25.3 mm with 83 parts on 70 nets, routed with 773 tracks and 198 vias.

It is built around the RP2040, W25Q128JVSIQ and SRV05-4, with the AMS1117-3.3 among its other parts. Its parts include 20 capacitors, 18 resistors, 6 diodes, 6 connectors and 5 ICs. It belongs with the RP2040 boards of this library.

Main components

4

README

README.md

HackDucky - A penetration testing tool.

What is HackDucky

HackDucky is a compact USB automation and security testing device designed in a small portable form factor. It is inspired by keystroke-injection tools and can emulate a USB keyboard to execute scripted commands automatically when plugged into a computer.The device is powered by a rp2040 and supports payload scripting, making it useful for automation, demonstrations, and authorized penetration testing. Below is the render of the HackDucky board. alt text

Why HackDucky

Most devices designed for USB automation or security testing are either expensive, closed-source, or difficult for beginners to modify. We wanted to build something compact, affordable, and easy to experiment with while still being powerful enough for real projects. HackDucky aims to provide a small, portable platform for USB automation, inspired by devices used in security research such as USB Rubber Ducky and other BadUSB-style tools.

Our board is powered by the reliable Raspberry Pi RP2040 microcontroller and includes 16 MB of flash storage, giving plenty of room for scripts and firmware. It also features an SD card slot, allowing users to store and switch between multiple payloads or automation scripts easily. This makes the device flexible for experimentation, demos, and authorized security testing.

HackDucky is designed for a wide range of users. Students can explore how USB HID devices work and learn about hardware security concepts. Makers can use it as a programmable USB automation tool for repetitive tasks. Security enthusiasts can experiment with BadUSB-style techniques in controlled environments, while developers can modify the firmware and hardware to create their own custom tools.

Features

  • RP2040 Microcontroller – Dual-core Arm Cortex-M0+ running at 133 MHz
  • 16 MB Flash Storage – Store firmware and large script libraries
  • USB-A + USB-C Ports – Flexible connection to different hosts
  • MicroSD Card Slot – External storage for payloads and logs
  • Led Indicator – Shows device status and script execution
  • HID Emulation – Can behave as a keyboard or other USB device
  • Script Execution – Run automation scripts automatically
  • Open Hardware Design – Fully customizable firmware and PCB
  • Compact Portable PCB – Designed for experimentation and hacking

Getting Started

Your HackDucky ships without firmware preinstalled, so you need to flash it before using the board.

Step 1 — Flash CircuitPython

  1. Visit the CircuitPython download page for the RP2040.
  2. Download the .uf2 firmware file.
  3. Plug your HackDucky into your computer.
  4. A drive named RPI-RP2 should appear.
  5. Drag and drop the .uf2 file onto the drive.

After flashing, a new drive named CIRCUITPY should appear.


Step 2 — Install the Firmware

  1. Clone the repository:
bash
git clone https://github.com/hackclub/hackducky
  1. Open the repository and navigate to the firmware directory.

  2. Copy all files from the firmware folder to the CIRCUITPY drive.

  3. Replace existing files if prompted.

  4. Delete the existing code.py file.

Step 3 — Add Your Script

  1. Open the ducks folder on the HackDucky drive.

  2. Delete any existing files in the folder.

  3. Copy your script into the folder with the .ducky extension.

  4. Your HackDucky is now ready to run scripts.

bash
Enjoy ¯\_(ツ)_/¯

Keystroke emulation (wait for video)

Your browser does not support the video tag.

Watch on YouTube

Team

  • @Souptik Samanta
  • @Aarav Jham
  • @Some1

Contact

Email Souptik at me@souptik.me(me[at]souptik[dot]me)

Parts

83
QtyValueFootprintReferences
12TestPointTestPoint:TestPoint_Pad_D1.0mmTP1, TP2, TP3, TP4, TP5, TP6, TP7, TP8, TP9, TP10, TP11, TP12
11100nFCapacitor_SMD:C_0402_1005MetricC7, C8, C11, C17, C18, C19, C20, C21, C22, C24, C25
10LOGOLOGOG***, G***, G***, G***, G***, G***, G***, G***, G***, G***
610kResistor_SMD:R_0402_1005MetricR16, R17, R18, R19, R20, R21
4220Resistor_SMD:R_0402_1005MetricR3, R5, R6, R10
4LEDLED_SMD:LED_0402_1005MetricD1, D2, D3, D4
31uFCapacitor_SMD:C_0402_1005MetricC1, C9, C10
322uFCapacitor_SMD:C_0603_1608MetricC14, C15, C23
2120ohm.100MhzInductor_SMD:L_0805_2012MetricFB1, FB2
215pFCapacitor_SMD:C_0402_1005MetricC12, C13
21kResistor_SMD:R_0402_1005MetricR8, R9
227.4Resistor_SMD:R_0402_1005MetricR7, R22
2LEDLED_SMD:LED_0603_1608MetricD5, D6
2RResistor_SMD:R_0402_1005MetricR1, R2
2SRV05-4Package_TO_SOT_SMD:SOT-23-6U5, U6
1100nCapacitor_SMD:C_0402_1005MetricC16
15.1KCapacitor_SMD:C_0402_1005MetricR4
1AMS1117-3.3Package_TO_SOT_SMD:SOT-223-3_TabPin2U2
1BOOT_SELButton_Switch_SMD:SW_Push_SPST_NO_Alps_SKRKSW3
1Conn_01x03_PinConnector_PinHeader_1.27mm:PinHeader_1x03_P1.27mm_VerticalJ4
1Conn_01x04_PinConnector_PinHeader_1.00mm:PinHeader_1x04_P1.00mm_VerticalJ6
1Conn_02x02_Top_BottomConnector_PinHeader_1.00mm:PinHeader_2x02_P1.00mm_Vertical_SMDJ2
1Crystal_GND24Crystal:Crystal_SMD_Abracon_ABM8G-4Pin_3.2x2.5mmY1
1DNFResistor_SMD:R_0402_1005MetricR15
1GP0Button_Switch_SMD:SW_Push_SPST_NO_Alps_SKRKSW4
1Jumper_2_OpenJumper:SolderJumper-2_P1.3mm_Open_RoundedPad1.0x1.5mmJP1
1Micro_SD_CardConnector_Card:microSD_HC_Hirose_DM3AT-SF-PEJM5J3
1RP2040Package_DFN_QFN:QFN-56-1EP_7x7mm_P0.4mm_EP3.2x3.2mmU4
1USB_AConnector_USB:USB_A_CNCTech_1001-011-01101_HorizontalJ1
1USB_C_PlugRASPBERRY_PI_PICO:USB-C-SMD_U261-121N-4BS2SP2
1W25Q128JVSPackage_SO:SOIC-8_5.3x5.3mm_P1.27mmU3

Similar boards

  • 4 layers63.5 × 40.6 mmIce2040, the printed circuit board in 3D

    Ice2040

    kevinjuszczyk/ice2040

    ice40 + RP2040 combo

    124 parts12
  • 4 layers50.1 × 32 mmPxl, the printed circuit board in 3D

    Pxl

    souptik-samanta/fluid-dynamics

    102 parts
  • 4 layers96 × 82 mmDreamdrivecast v1a, the printed circuit board in 3D

    Dreamdrivecast v1a

    khill25/Dreamdrive

    Open source Retro Rom Carts and ODEs by Dreamcraft Industries

    76 parts26
  • 4 layers90 × 100 mmPump board, the printed circuit board in 3D

    Pump board

    TrendBit/SMBR-hardware

    Design file for SMBR hardware modules in KiCAD.

    204 partsGPL-3.0
  • 2 layers63.5 × 58 mmLatest, the printed circuit board in 3D

    Latest

    minipadKB/minipad

    The PCB and case files for the minipad, an RP2040-based 2-3-key keypad for the rhythm game osu!.

    39 parts52GPL-3.0
  • 2 layers224.4 × 97.8 mmKnobdeavour, the printed circuit board in 3D

    Knobdeavour

    ScatteredDrifter/Buran-Ortho

    A 39-key orthogonal keyboard with support for two knobs, based on a rp2040

    105 parts46
  • 2 layers253.3 × 113.3 mmCut slope, the printed circuit board in 3D

    Cut slope

    hazels-garage/cut-slope

    119 parts29
  • 2 layers344.7 × 123.6 mmSlime88, the printed circuit board in 3D

    Slime88

    zykrah/slime88

    A F13 TKL Multi-Layout Hotswap H88-Compat Type-C PCB

    243 parts29

Questions

How big is the Hackducky PCB?

It measures 52.3 × 25.3 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Hackducky use?

83 parts, built around the RP2040, W25Q128JVSIQ, SRV05-4 and AMS1117-3.3. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Hackducky KiCad files?

From the souptik-samanta/Hackducky repository on GitHub, at the commit this page was made from: the board is Pcb/hackducky.kicad_pcb and its schematic Pcb/hackducky.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Hackducky design in my own project?

Its repository states no licence, so its author keeps all rights: ask souptik-samanta before reusing the design.