From d4957e2e955cba381522fecd3a0290286c8d1257 Mon Sep 17 00:00:00 2001 From: Dave Date: Mon, 26 Sep 2022 20:59:21 -0500 Subject: [PATCH] Doc updates (#104) * Update instructions to include copying boot.py * Clean up instructions * Fix formatting --- README.md | 30 +++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index e734d35..cab26e9 100644 --- a/README.md +++ b/README.md @@ -20,25 +20,30 @@ Install and have your USB Rubber Ducky working in less than 5 minutes. -1. Download [CircuitPython for the Raspberry Pi Pico](https://circuitpython.org/board/raspberry_pi_pico/). *Updated to 7.0.0 +1. Clone the repo to get a local copy of the files. `git clone https://github.com/dbisu/pico-ducky.git` -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`. +2. Download [CircuitPython for the Raspberry Pi Pico](https://circuitpython.org/board/raspberry_pi_pico/). *Updated to 7.0.0 -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`. +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`. -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. +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`. -5. Navigate to `lib` in the recently extracted folder and copy `adafruit_hid` to the `lib` folder on your Raspberry Pi Pico. +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. -6. Copy `adafruit_debouncer.mpy` and `adafruit_ticks.mpy` to the `lib` folder on your Raspberry Pi Pico. +6. Navigate to `lib` in the recently extracted folder and copy `adafruit_hid` to the `lib` folder on your Raspberry Pi Pico. -7. Copy `asyncio` to the `lib` folder on your Pico. +7. Copy `adafruit_debouncer.mpy` and `adafruit_ticks.mpy` to the `lib` folder on your Raspberry Pi Pico. -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. +8. Copy `asyncio` to the `lib` folder on your Pico. -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. +9. Copy `boot.py` from your clone to the root of your Pico. -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. +10. Copy `duckyinpython.py` as `code.py` in the root of the Raspberry Pi Pico, overwriting the previous file. + Linux: `cp duckyinpython.py