{"id":17563980,"url":"https://github.com/hnfull/splendente-usb","last_synced_at":"2025-06-14T21:03:48.634Z","repository":{"id":108935094,"uuid":"182307590","full_name":"Hnfull/Splendente-USB","owner":"Hnfull","description":"Copy data from target machine to USB key and USB key to target machine with an open session","archived":false,"fork":false,"pushed_at":"2020-07-11T00:18:38.000Z","size":10309,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-12T13:57:48.385Z","etag":null,"topics":["badusb","python3","rubber-ducky","usb","windows"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Hnfull.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2019-04-19T18:19:36.000Z","updated_at":"2024-09-24T08:01:26.000Z","dependencies_parsed_at":"2023-04-18T05:17:46.101Z","dependency_job_id":null,"html_url":"https://github.com/Hnfull/Splendente-USB","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hnfull%2FSplendente-USB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hnfull%2FSplendente-USB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hnfull%2FSplendente-USB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hnfull%2FSplendente-USB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hnfull","download_url":"https://codeload.github.com/Hnfull/Splendente-USB/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hnfull%2FSplendente-USB/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":258574327,"owners_count":22722612,"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":["badusb","python3","rubber-ducky","usb","windows"],"created_at":"2024-10-21T13:10:46.026Z","updated_at":"2025-06-14T21:03:48.611Z","avatar_url":"https://github.com/Hnfull.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Splendente-USB\n\n![](https://img.shields.io/badge/Python-\u003e=3.5-blue.svg)\n![](https://img.shields.io/badge/Version-1.0.4-green.svg)\n![](https://img.shields.io/badge/Licence-MIT-red.svg)\n\n- Copy data from target machine to USB key and  from USB key to target machine with an open session by connecting on target machine a multiports USB adapator that contained one rubber ducky and one usb key inserted\n\n## Targets\n- Windows platform only\n\n## Targets platforms tested\n- Windows 7 \u0026 10\n\n## Requirements\n- Python \u003e= 3.5\n- requirements.txt\n- 1 USB key\n- 1 Rubber Ducky\n- 1 Adaptator usb-c or usb 2.0 or 3.0 with USB multiports (In order to plug your rubber ducky and your USB key in same time)\n\n## Installation\n`git clone https://github.com/Hnfull/Splendente-USB.git`\n\n`pip3 install -r Splendente-USB/requirements.txt`\n\n## Features\n- Copy file(s) from target directories to USB key : \n  - -\u003e UserHome\n  - -\u003e Documents \n  - -\u003e Pictures\n  - -\u003e Downloads\n  - -\u003e Desktop\n  - -\u003e Contacts\n  - -\u003e Dropbox\n  - -\u003e OneDrive\n  - -\u003e Outlook\n  - -\u003e SSH keys\n  - -\u003e Mozilla Firefox\n  - -\u003e Google Chrome\n  - -\u003e Microsoft Edge\n  - -\u003e Other mounted partitions \n  \n- Copy file(s) from USB key to target directory + persistence\n\n## Usages\n- 1 Rename your USB key to `USB_DATA`\n- 2 Copy `Splendente-USB` repository into USB key labeled 'USB_DATA'\n- 3 Open powershell or cmd and move into your USB key `cd YourLetterKey:\\`\n- 4 Since your USB key `cd Splendente-USB/splendente`\n- 5 Packaged  `splendente_usb.py` with pyinstaller -\u003e `pyinstaller --specpath setup/ --workpath setup/build --distpath setup/dist --clean -F --noconsole .\\splendente_usb.py`\n- 6 (Optional) In `USB_DATA/Splendente-USB/agent/` directory place your file that you want copy from USB to target\n- 7 Take the `Splendente-USB/rubber_ducky_script/duckycode.txt` file and encode it (https://ducktoolkit.com/encode#), then place the generated `inject.bin` file in your Rubber Ducky\n- 8 Using a multi-USB adapter, insert your Rubber Ducky and USB key labeled 'USB_DATA'\n- 9 Plug in your USB adapter!\n\n## Directories of USB Tree \n- USB key (USB_DATA) \n  - `USB_DATA/Splendente-USB/data_*` : directory of data copied from target, will be appear when after launch program \n  - `USB_DATA/Splendente-USB/agent/` : copy file(s) from USB key to target + persistence (optional) \n  - `USB_DATA/Splendente-USB/conf/splendente.ini` :  manage files and directories that you want copy \n  - `USB_DATA/Splendente-USB/log/splendente.log` : traceability of actions \n  - `USB_DATA/Splendente-USB/splendente/setup/dist/splendente_usb.exe` : main exe program will be appear after launch of      -        `pyinstaller` command and that will be executed by the rubber_ducky device \n\n- Rubber Ducky\n  - `yourRubberDucky/inject.bin` : rubber ducky script compiled \n\n## Todo\n- Version 1.0.0-x\n  - code optimization\n  - Several path additions\n  - Fix bug and problems\n  - Improved features already present\n  \n## License\n- MIT\n\n## Contact\n- Hnfull **gitland@protonmail.com**\n\n## Disclaimer\n- Splendente-USB is for education/research purposes only. The author takes NO responsibility ay for how you choose to use any of the tools provided\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhnfull%2Fsplendente-usb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhnfull%2Fsplendente-usb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhnfull%2Fsplendente-usb/lists"}