Skip to content

Commit d4957e2

Browse files
authored
Doc updates (#104)
* Update instructions to include copying boot.py * Clean up instructions * Fix formatting
1 parent 6516c8b commit d4957e2

File tree

1 file changed

+17
-13
lines changed

1 file changed

+17
-13
lines changed

README.md

+17-13
Original file line numberDiff line numberDiff line change
@@ -20,25 +20,30 @@
2020

2121
Install and have your USB Rubber Ducky working in less than 5 minutes.
2222

23-
1. Download [CircuitPython for the Raspberry Pi Pico](https://circuitpython.org/board/raspberry_pi_pico/). *Updated to 7.0.0
23+
1. Clone the repo to get a local copy of the files. `git clone https://github.com/dbisu/pico-ducky.git`
2424

25-
2. Plug the device into a USB port while holding the boot button. It will show up as a removable media device named `RPI-RP2`.
25+
2. Download [CircuitPython for the Raspberry Pi Pico](https://circuitpython.org/board/raspberry_pi_pico/). *Updated to 7.0.0
2626

27-
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`.
27+
3. Plug the device into a USB port while holding the boot button. It will show up as a removable media device named `RPI-RP2`.
2828

29-
4. Download `adafruit-circuitpython-bundle-7.x-mpy-YYYYMMDD.zip` [here](https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest) and extract it outside the device.
29+
4. 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`.
3030

31-
5. Navigate to `lib` in the recently extracted folder and copy `adafruit_hid` to the `lib` folder on your Raspberry Pi Pico.
31+
5. Download `adafruit-circuitpython-bundle-7.x-mpy-YYYYMMDD.zip` [here](https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest) and extract it outside the device.
3232

33-
6. Copy `adafruit_debouncer.mpy` and `adafruit_ticks.mpy` to the `lib` folder on your Raspberry Pi Pico.
33+
6. Navigate to `lib` in the recently extracted folder and copy `adafruit_hid` to the `lib` folder on your Raspberry Pi Pico.
3434

35-
7. Copy `asyncio` to the `lib` folder on your Pico.
35+
7. Copy `adafruit_debouncer.mpy` and `adafruit_ticks.mpy` to the `lib` folder on your Raspberry Pi Pico.
3636

37-
8. 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.
37+
8. Copy `asyncio` to the `lib` folder on your Pico.
3838

39-
9. 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.
39+
9. Copy `boot.py` from your clone to the root of your Pico.
4040

41-
10. 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.
41+
10. Copy `duckyinpython.py` as `code.py` in the root of the Raspberry Pi Pico, overwriting the previous file.
42+
Linux: `cp duckyinpython.py </path/to/pico/code.py`
43+
44+
11. 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.
45+
46+
12. 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.
4247

4348
### Setup mode
4449

@@ -50,11 +55,10 @@ The easiest way to so is by using a jumper wire between those pins as seen bello
5055
### USB enable/disable mode
5156

5257
If you need the pico-ducky to not show up as a USB mass storage device for stealth, follow these instructions.
53-
Enter setup mode.
54-
Copy boot.py to the root of the pico-ducky.
58+
Enter setup mode.
5559
Copy your payload script to the pico-ducky.
5660
Disconnect the pico from your host PC.
57-
Connect a jumper wire between pin 18 (`GND`) and pin 20 (`GPIO15`).
61+
Connect a jumper wire between pin 18 (`GND`) and pin 20 (`GPIO15`).
5862
This will prevent the pico-ducky from showing up as a USB drive when plugged into the target computer.
5963
Remove the jumper and reconnect to your PC to reprogram.
6064
The default mode is USB mass storage enabled.

0 commit comments

Comments
 (0)