{"adoption": {"forks": 151, "observed_at": "2026-08-28T04:03:13.056959+00:00", "stars": 1010}, "canonical_url": "https://ross.abutalabs.com/products/facedancer", "card": {"archived": false, "artifact_type": "library", "description": "Implement your own USB device in Python, supported by a hardware peripheral such as Cynthion or GreatFET", "domain": ["security", "hardware", "developer-tools", "embedded-systems", "penetration-testing"], "enriched": true, "function": ["security", "simulation", "developer-tools", "testing", "fuzzing"], "health_score": 89, "homepage": null, "language": "Python", "license": "BSD-3-Clause", "license_family": "permissive", "maturity": "active", "member_repos": ["greatscottgadgets/facedancer"], "name": "greatscottgadgets/facedancer", "platform": ["python", "cross-platform"], "pushed_at": "2026-05-22T08:51:50+00:00", "repo": "greatscottgadgets/facedancer", "stars": 1010, "tags": ["usb", "usb-emulation", "hardware-hacking", "usb-proxy", "mitm", "cynthion", "greatfet", "usb-host-testing", "linux", "macos"], "topics": [], "urls": [], "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"], "what_it_is": "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.", "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"], "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"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/facedancer", "repo": "greatscottgadgets/facedancer", "role": "main", "score": 83}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:03:13.056959+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T07:11:56.778362+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "812b0aa7f6f28d187eedeee5bf1537fc721e6cebd37fd4e404fce0eebf717de6", "fetched_at": "2026-08-28T04:03:13.056959+00:00", "kind": "readme", "missing": false, "url": "https://github.com/greatscottgadgets/facedancer"}, {"content_hash": "16e619ce29b55c911fd9c021749f41a1e46a4049abff9aa838e15f3eaeb59fe9", "fetched_at": "2026-08-29T13:11:53.747617+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/facedancer/json"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 83, "longevity": 100, "rhythm": 73}, "computed_at": "2026-09-02T17:46:02.011165+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 3501, "days_push": 103, "days_rel": 103, "gap_med": 46, "n_releases_24m": 8}, "score": 83, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}