Coder Social home page Coder Social logo

feathers2-ducky's Introduction

feathers2-ducky

Make a powerful USB Rubber Ducky with a FeatherS2 board

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 FeatherS2. Currently version is 7.0.0

  2. Plug the device into a USB port. Press the Reset button, then within a second it the boot button. It will show up as a removable media device named UFTHRS2BOOT.

  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.

  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 on your FeatherS2.

  6. Also from lib, copy adafruit_wsgi to the lib folder on your FeatherS2.

  7. Connect pin IO35 (IO35) to pin 4 (GND). This will enable setup mode once the files are copied to the FeatherS2.

  8. Download boot.py, code.py, ducyinpython.py, webapp.py, and wsgserver.py.

  9. Download adafruit_wsgi/wsgi_app.py and copy to lib/adafruit_wsgi on the FeatherS2. Remove wsgi_app.mpy from that folder.

  10. Copy boot.py, code.py, ducyinpython.py, webapp.py, and wsgserver.py to the root of the FeatherS2.

  11. Find a script here or create your own one using Ducky Script and save it as payload.dd on the FeatherS2.

  12. Create the file secrets.py in the root of the FeatherS2. This contains the AP name and password to be created by the FeatherS2.
    secrets = { 'ssid' : "BadAPName", 'password' : "badpassword" }

  13. Unplug the FeatherS2, remove the jumper from IO35, and plug back in your FeatherS2.

  14. The FeatherS2 should reboot into AP mode, serving from the address of http://192.168.4.1

  15. Navigating to http://192.168.4.1 should list out the available payloads. You can run the scripts from the menus.

Setup mode

To edit the payload, enter setup mode by connecting the pin IO35 (IO35) to pin 4 (GND), this will stop the feathers2-ducky from starting the Wifi and will reenable USB drive function. The easiest way to so is by using a jumper wire between those pins.

FeatherS2 pinout

Example w/ Hardware Switch

FeatherS2 switch front

FeatherS2 switch back

Changing Keyboard Layouts

See the Wiki

Useful links and resources

Docs

CircuitPython

CircuitPython HID

Ducky Script

Video tutorials

pico-ducky tutorial by NetworkChuck

USB Rubber Ducky playlist by Hak5

CircuitPython tutorial on the Raspberry Pi Pico by DroneBot Workshop

feathers2-ducky's People

Contributors

dbisu avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.