greatscottgadgets/facedancer
Implement your own USB device in Python, supported by a hardware peripheral such as Cynthion or GreatFET observed · 2026-08-28
Health v2 · maintenance only
83/100
- Activity 83
- Release rhythm 73
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-02. Adoption (stars, forks) is never an input.
- gap_med: 46
- age_days: 3501
- days_rel: 103
- days_push: 103
- n_releases_24m: 8
Adoption not part of the score
1010 stars · 151 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
A Python library for emulating USB devices using hardware peripherals like Cynthion or GreatFET. It also supports MITM proxying of USB connections for protocol analysis and live packet manipulation.
Use cases
- emulate a custom USB device in Python
- fuzz USB host controllers
- MITM and sniff USB traffic between a device and host
- reverse engineer a proprietary USB protocol
- test how an embedded system or games console responds to malformed USB devices
When to choose
- you need fine-grained control over USB device behavior, including intentional misbehaviors
- you own compatible hardware such as Cynthion, GreatFET, or Facedancer boards
- you want to proxy or manipulate live USB connections without controlling the target software
When to avoid
- you need pure software USB emulation without dedicated hardware
- you rely on legacy Facedancer v2.x scripts, which are incompatible with 3.0
- you only need to analyze USB captures passively rather than interact with hardware
Facets
library · maturity active
security simulation developer-tools testing fuzzing security hardware developer-tools embedded-systems penetration-testing python cross-platform usb usb-emulation hardware-hacking usb-proxy mitm cynthion greatfet usb-host-testing linux macos
2 sources
- readme: https://github.com/greatscottgadgets/facedancer · fetched 2026-08-28 · 812b0aa7f6f2
- registry_pypi: https://pypi.org/pypi/facedancer/json · fetched 2026-08-29 · 16e619ce29b5
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| greatscottgadgets/facedancer | main | 83 |
For agents
markdown · JSON · MCP: product_card(name="greatscottgadgets/facedancer")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem