You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+17-13
Original file line number
Diff line number
Diff line change
@@ -20,25 +20,30 @@
20
20
21
21
Install and have your USB Rubber Ducky working in less than 5 minutes.
22
22
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`
24
24
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
26
26
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`.
28
28
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`.
30
30
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.
32
32
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.
34
34
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.
36
36
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.
38
38
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.
40
40
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.
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.
42
47
43
48
### Setup mode
44
49
@@ -50,11 +55,10 @@ The easiest way to so is by using a jumper wire between those pins as seen bello
50
55
### USB enable/disable mode
51
56
52
57
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.
55
59
Copy your payload script to the pico-ducky.
56
60
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`).
58
62
This will prevent the pico-ducky from showing up as a USB drive when plugged into the target computer.
59
63
Remove the jumper and reconnect to your PC to reprogram.
0 commit comments