Skip to content

Latest commit

 

History

History
60 lines (31 loc) · 2.74 KB

README.md

File metadata and controls

60 lines (31 loc) · 2.74 KB
Raw

circuitexpress-ducky

Make a cheap but powerful USB Rubber Ducky with an Adafruit Circuit Playground Express

Forked from dbisu/pico-ducky

Buy a Circuit Playground Express here

GitHub code size in bytes GitHub license GitHub contributors GitHub commit activity GitHub Repo stars

Install

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

  1. Download CircuitPython for the Adafruit Circuit Playground Express. *Updated to 7.1.1

  2. Plug the device into a USB port while holding the boot button. It will show up as a removable media device named CPLAYBOOT.

  3. Copy the downloaded .uf2 file to the root of the board (CPLAYBOOT). The device will reboot and after a second or so, it will reconnect as CIRCUITPY.

  4. Download adafruit-circuitpython-bundle-7.x-mpy-YYYYMMDD.zip here and extract it outside the device.

  5. Navigate to lib in the recently extracted folder and copy adafruit_hid to the lib folder in your Circuit Playground.

  6. Click here, press CTRL + S and save the file as code.py in the root of the Circuit Playground, overwriting the previous file.

  7. Find a script here or create your own one using Ducky Script and save it as payload.dd in the board.

Setup mode

To edit the payload, enter setup mode by holding down Button A on the board when it is plugged in, this will stop the circuit playground from injecting the payload in your own machine.

Useful links and resources

Docs

CircuitPython

CircuitPython HID

Ducky Script