{"id":15163214,"url":"https://github.com/devkitty-io/usb-nugget","last_synced_at":"2025-09-30T17:31:18.918Z","repository":{"id":37032164,"uuid":"466065454","full_name":"DevKitty-io/USB-Nugget","owner":"DevKitty-io","description":"Run DuckyScript payloads on a USB Nugget!  ","archived":true,"fork":false,"pushed_at":"2023-02-09T05:45:15.000Z","size":6047,"stargazers_count":158,"open_issues_count":24,"forks_count":19,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-09-29T18:42:26.166Z","etag":null,"topics":["esp32s2","hid-attacks","keystroke-injection","tinyusb","usb-hid","usb-nugget"],"latest_commit_sha":null,"homepage":"https://usbnugget.com","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DevKitty-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-04T09:42:15.000Z","updated_at":"2024-09-29T05:41:29.000Z","dependencies_parsed_at":"2024-08-22T15:32:00.502Z","dependency_job_id":"c8f1fc2f-75e7-434d-b901-fa53fab696f1","html_url":"https://github.com/DevKitty-io/USB-Nugget","commit_stats":null,"previous_names":["devkitty-io/usb-nugget"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKitty-io%2FUSB-Nugget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKitty-io%2FUSB-Nugget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKitty-io%2FUSB-Nugget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKitty-io%2FUSB-Nugget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevKitty-io","download_url":"https://codeload.github.com/DevKitty-io/USB-Nugget/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234760680,"owners_count":18882574,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["esp32s2","hid-attacks","keystroke-injection","tinyusb","usb-hid","usb-nugget"],"created_at":"2024-09-27T02:21:23.525Z","updated_at":"2025-09-30T17:31:13.428Z","avatar_url":"https://github.com/DevKitty-io.png","language":"C","readme":"# **USB Nugget**: Cat-Themed USB Attacks\nA versatile USB attack platform that lets you hack computers in seconds using a [USB Nugget](https://usbnugget.com)!  \n\n\u003cimg src=\"images/USB-Nugget.png\"  /\u003e\n\n## Resources:\n- [USB Nugget Payloads](https://github.com/HakCat-Tech/USB-Nugget-Payloads)  \n- [Hak5 Payloads](https://docs.hak5.org)\n\n## How to Update your Nugget:\n1.\t[Download the latest binary file here](https://github.com/HakCat-Tech/USB-Nugget/releases/)\n2.\tPlace your Nugget in [Device Firmware Upgrade (DFU) mode]().\n4.\tOpen our [web flasher tool](https://hakcat-tech.github.io/esp-web-flasher/) in Google Chrome (other browsers not currently supported)\n5.\tClick on \"Connect\" and then select the \"ESP32-S2\" board. Click \"Erase\" and \"OK\" to continue.\n6.\tOnce you see \"Finished\", click \"Choose a file\" and select the .BIN file you downloaded in step one. Click \"Program\" to flash your Nugget!\n7.\tWhen its done, unplug your Nugget and plug it in again to see the new features. \n\n## Creating Payloads\nTo upload a payload, you can save a `.txt` file to the USB Nugget flash drive.  Payloads must be saved under an operating system, then category type. (OS-\u003eCategory-\u003ePayload.txt)\n\n## Accessing the Web Interface\nTo access the web interface, connect to `Nugget AP` with the password `nugget123`.  In a web browser, navigate to `192.168.4.1` to access the payload deployment system.\n\n## Updating AP Credentials \u0026 Keyboard ID\nTo edit your USB Nugget's default AP name \u0026 password, edit or create the `.usbnugget.conf` file on your NUGGET drive, and add the following 2 lines:\n```\nnetwork = \"Nugget AP\"\npassword = \"nugget123\"\n```\nTo change the VID and PID of the keyboard, you can just add:\n```\nvid = \"0x05ac\"\npid = \"0x20b\"\n```\n\nIf `.usbnugget.conf` is not present or contains invalid entries, the above\nsettings will be used.\n\n## Current Features\n\n- DuckyScript Compatible\n    - Basic syntax: `STRING`, `DELAY`, keypress combos\n    - Basic colors: `R` `G` `B` `C` `Y` `M` `W`\n    - International keyboard support\n\t- German: `LOCALE DE`\n\t- US English: `LOCALE EN`\n\t- Spanish: `LOCALE ES`\n\t- French: `LOCALE FR`\n\t- Portuguese: `LOCALE PT`\n- Web Interface \n    - Deploy payloads\n    - Edit payloads\n    - Create new payloads\n- USB Flash Drive\n    - FAT filesystem\n    - Create default OS folders\n    - Follows Hak5 naming convention (OS-\u003eCategory-\u003ePayload)\n- Nugget Interface\n    - Custom graphics\n    - Live command preview\n    - Reactive RGB NeoPixel\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevkitty-io%2Fusb-nugget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevkitty-io%2Fusb-nugget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevkitty-io%2Fusb-nugget/lists"}