A powerful WiFi USB Rubber Ducky built on the Raspberry Pi Pico W. Control it wirelessly from any device with a web browser.
PiPo Ducky turns a Raspberry Pi Pico W into a wireless HID device that can:
It’s like a Bash Bunny, but runs on a $4 Pico W with just a USB cable.
The Pico W emulates a USB keyboard and mouse. Send keystrokes, key combos, mouse movements, and clicks to the connected computer.
When devices connect to the PiPo_Ducky WiFi, they automatically see a customizable login page (like hotel or airport WiFi). You control what the page shows - a fake login, a real website, or any HTML you want.
Control everything from your phone or laptop’s browser:
.picods scripts from your computerControl the onboard LED from scripts or the web UI for visual feedback.
See how much space is used on the device at a glance.
Every script requires confirmation before running, with a warning about what it will do.
┌──────────────────┐ WiFi AP ┌──────────────────┐
│ Your Phone/ │ ◄──────────────────────► │ PiPo Ducky │
│ Laptop │ 192.168.4.1 │ (Pico W) │
│ │ │ │
│ Web Browser │ POST /api {script} │ USB Cable │
│ opens UI │ ─────────────────────► │ to computer │
│ │ │ │ │
└──────────────────┘ └────────┼────────┘
│
▼
┌──────────────┐
│ Host PC │
│ gets keyboard│
│ & mouse input│
└──────────────┘
PiPo_Ducky)192.168.4.1 in your browserDownload CircuitPython
Go to circuitpython.org and download the latest CircuitPython .uf2 file for Pico W.
BOOTSEL button on the Pico WRPI-RP2 will appear.uf2 file onto the driveCIRCUITPY will appearpico-w folder to this drivecode.py, duck.py, boot.py, index.html are in the rootlib folder is copied with all .mpy files insidePiPo_Ducky (password: ppod_430d)192.168.4.1 in your browser| Setting | Value |
|---|---|
| SSID | PiPo_Ducky |
| Password | ppod_430d |
| IP Address | 192.168.4.1 |
By default, the USB mass storage drive is hidden (stealth mode). To enable it:
CIRCUITPY drive will appearYou can also toggle USB storage from the Settings tab in the web UI.
Scripts use the .picods file extension. They can be stored in two places:
| Location | Purpose |
|---|---|
/scripts on CIRCUITPY drive |
On-device scripts, shown in web UI |
PiPo-Ducky-scripts/ repo |
Community scripts, copy to device |
#T> Script Title
#D> Short description
#R> Requirements
#N> Notes
DELAY 1000
GUI r
STRING notepad
ENTER
See Scripting Documentation for the full command reference.
.picods file.picods file from your computerEdit the HTML for the captive portal page. This is what people see when they connect to the WiFi. You can put:
The PiPo-Ducky-scripts/ directory contains community-made scripts:
| Script | Description |
|---|---|
hello-world.picods |
Opens Notepad and types a greeting |
mouse-demo.picods |
Demonstrates mouse movement and clicking |
led-blink.picods |
Blinks the LED in a pattern |
pipo-alert.picods |
Shows a popup alert |
rickroll.picods |
Rickrolls someone via terminal |
ctrlpnl.picods |
Opens Control Panel |
fake-update.picods |
Shows a fake Windows update screen |
fakeshutdown.picods |
Shows a fake shutdown screen |
sys-prop.picods |
Opens System Properties |
.picods script with metadata (#T>, #D>, #R>, #N>)| Problem | Solution |
|---|---|
| Can’t connect to WiFi | Make sure you’re near the Pico W, try forgetting and reconnecting |
| Page won’t load | Try http://192.168.4.1 (not https) |
| Script doesn’t work | Add more DELAY after actions, check if target software is open |
| LED doesn’t blink | Check that boot.py is in the root of CIRCUITPY drive |
| USB drive not showing | Connect GP15 to GND, then replug USB |
GPL v3 - See LICENSE for details.