Rusbpy

USB Automation Script (Adafruit CircuitPython HID)

This project demonstrates how to use an Adafruit board running CircuitPython as a Human Interface Device (HID) to automate keyboard input.

Think of it like a programmable keyboard macro tool (similar to a Rubber Ducky concept, but legal & DIY).

✅ What This Project Does

Sends keystrokes automatically (like a macro keyboard)

Useful for:

automation demos

educational cybersecurity practice

testing input automation

productivity shortcuts

❌ What This Project Does NOT Do

It is not designed for unauthorized access

Not intended for malicious activity

Does not bypass login screens or security systems

🛠 Requirements Requirement Description Adafruit board e.g., Adafruit Trinket M0 / QT Py / ItsyBitsy CircuitPython Latest version installed adafruit_hid library Must be copied to CIRCUITPY/lib/ USB cable For power + HID

Usefull Repos

Official hak5 repo: https://github.com/hak5/usbrubberducky-payloads

Adafruit HID Docs: https://docs.circuitpython.org/projects/hid/en/latest/

CircuitPython Guide: https://learn.adafruit.com/

Keyboard Layouts: https://github.com/Neradoc/Circuitpython_Keyboard_Layouts/blob/main/PICODUCKY.md