DocRock3r/pico-ducky
1
0
Fork 0
mirror of https://github.com/dbisu/pico-ducky.git synced 2025-12-06 02:41:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

update README instructions and formatting (#9)

Browse Source 
add badges and useful resources to README
change payload  to open notepad and type "Hello World!" in Windows
fix comments in duckyinpython.py
rename "pics" folder to "images"
update setup mode image to a clearer one
This commit is contained in:
Peter Fritz
2021-08-28 18:38:51 -03:00
committed by GitHub
parent 2e676ca902
commit 4ad9a94943
5 changed files with 64 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

73
README.md
View File

@@ -1,37 +1,62 @@
# pico-ducky
Create a USB Rubber Ducky like device using a Raspberry PI Pico
<h1 align="center">pico-ducky</h1>
Download circuitpython for pico board:
https://circuitpython.org/board/raspberry_pi_pico/
<div align="center">
<strong>Make a cheap but powerful USB Rubber Ducky with a Raspberry Pi Pico</strong>
</div>
Plug the Pico board into a USB port.
The board will show up as a removable media device.
Copy the UF2 file to the root of the media device.
<br />
The Pico board will reboot after installing the firmware image.
<div align="center">
<img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/dbisu/pico-ducky">
<img alt="GitHub license" src="https://img.shields.io/github/license/dbisu/pico-ducky">
<a href="https://github.com/dbisu/pico-ducky/graphs/contributors"><img alt="GitHub contributors" src="https://img.shields.io/github/contributors/dbisu/pico-ducky"></a>
<img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/dbisu/pico-ducky">
<img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/dbisu/pico-ducky">
</div>
Download additional libraries:
https://github.com/adafruit/Adafruit_CircuitPython_Bundle
<br />
https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/tag/20210130
## Install
from zip file, unpack adafruit_hid folder.
copy adafruit_hid to the lib folder.
Install and have your USB Rubber Ducky working in less than 5 minutes.
Circuitpy HID
https://learn.adafruit.com/circuitpython-essentials/circuitpython-hid-keyboard-and-mouse
1. Download [CircuitPython for the Raspberry Pi Pico](https://circuitpython.org/board/raspberry_pi_pico/).
2. Plug the device into a USB port. It will show up as a removable media device named `RPI-RP2`.
# Ducky Script Python
Copy duckyinpython.py to the root of the media device as code.py
3. Copy the downloaded `.uf2` file to the root of the Pico (`RPI-RP2`). The device will reboot and after a second or so, it will reconnect as `CIRCUITPY`.
$ cp duckyinpython.py /<path to media device>/code.py
4. Download `adafruit-circuitpython-bundle-6.x-mpy-YYYYMMDD.zip` [here](https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest) and extract it outside the device.
Copy your Ducky Script file as payload.dd
5. Navigate to `lib` in the recently extracted folder and copy `adafruit_hid` to the `lib` folder in your Raspberry Pi Pico.
$ cp <duckyscriptfile> /path to media device>/payload.dd
6. Click [here](https://raw.githubusercontent.com/dbisu/pico-ducky/main/duckyinpython.py), press CTRL + S and save the file as `code.py` in the root of the Raspberry Pi Pico, overwriting the previous file.
# NEW: added support for a programming switch.
Tie pin 0 (GPIO0) to pin 3 (GND) to not automatically run payloads.
Easiest way to do this is to add a jumper wire between those pins.
![jumper wire](pics/jumper.png)
7. Find a script [here](https://github.com/hak5darren/USB-Rubber-Ducky/wiki/Payloads) or [create your own one using Ducky Script](https://github.com/hak5darren/USB-Rubber-Ducky/wiki/Duckyscript) and save it as `payload.dd` in the Pico.
8. Be careful, if your device isn't in [setup mode](#setup-mode), the device will reboot and after half a second, the script will run.
### Setup mode
To edit the payload, enter setup mode by connecting the pin 1 (`GP0`) to pin 3 (`GND`), this will stop the pico-ducky from injecting the payload in your own machine.
The easiest way to so is by using a jumper wire between those pins as seen bellow.
![Setup mode with a jumper](images/setup-mode.png)
## Useful links and resources
### Docs
[CircuitPython](https://circuitpython.readthedocs.io/en/6.3.x/README.html)
[CircuitPython HID](https://learn.adafruit.com/circuitpython-essentials/circuitpython-hid-keyboard-and-mouse)
[Ducky Script](https://github.com/hak5darren/USB-Rubber-Ducky/wiki/Duckyscript)
### Video tutorials
[pico-ducky tutorial by **NetworkChuck**](https://www.youtube.com/watch?v=e_f9p-_JWZw)
[USB Rubber Ducky playlist by **Hak5**](https://www.youtube.com/playlist?list=PLW5y1tjAOzI0YaJslcjcI4zKI366tMBYk)
[CircuitPython tutorial on the Raspberry Pi Pico by **DroneBot Workshop**](https://www.youtube.com/watch?v=07vG-_CcDG0)