{"id":14967296,"url":"https://github.com/teapixl/pico-netcat-reverse-shell","last_synced_at":"2025-06-26T10:35:27.446Z","repository":{"id":170477486,"uuid":"500955517","full_name":"TeaPixl/Pico-NetCat-Reverse-Shell","owner":"TeaPixl","description":"NetCat Reverse Shell using the Raspberry Pi Pico as a Rubber Ducky to inject a script","archived":false,"fork":false,"pushed_at":"2022-06-07T19:13:18.000Z","size":10,"stargazers_count":22,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T09:51:54.998Z","etag":null,"topics":["circuit-python","dbisu","hak5","micro-python","pico","python","rasberry-pi","usb"],"latest_commit_sha":null,"homepage":"","language":null,"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/TeaPixl.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-06-07T18:16:17.000Z","updated_at":"2025-03-04T16:12:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"ddcf2c73-5b9b-4b20-b3d4-b25c4b3fc60f","html_url":"https://github.com/TeaPixl/Pico-NetCat-Reverse-Shell","commit_stats":{"total_commits":6,"total_committers":1,"mean_commits":6.0,"dds":0.0,"last_synced_commit":"7e3304ddc66aa30847dc62da7c5cd446935f3c5b"},"previous_names":["teapixl/pico-netcat-reverse-shell"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TeaPixl/Pico-NetCat-Reverse-Shell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeaPixl%2FPico-NetCat-Reverse-Shell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeaPixl%2FPico-NetCat-Reverse-Shell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeaPixl%2FPico-NetCat-Reverse-Shell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeaPixl%2FPico-NetCat-Reverse-Shell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TeaPixl","download_url":"https://codeload.github.com/TeaPixl/Pico-NetCat-Reverse-Shell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeaPixl%2FPico-NetCat-Reverse-Shell/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262049138,"owners_count":23250686,"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":["circuit-python","dbisu","hak5","micro-python","pico","python","rasberry-pi","usb"],"created_at":"2024-09-24T13:37:48.495Z","updated_at":"2025-06-26T10:35:27.429Z","avatar_url":"https://github.com/TeaPixl.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pico-NetCat-Reverse-Shell\n\nThe Pico `NetCat` Reverse Shell script uses a `Raspberry Pi Pico` as a USB `Rubber Ducky`\n\n## What is a Rubber Ducky?\n\nA Rubber Ducky is a hacking tool used to act as a `HID-compliant device` (like a keyboard) and injects a payload using it (Like in Mr.Robot!)\n\nCheck out [dbisu's Pico-Ducky](https://github.com/dbisu/pico-ducky) and [Hak5](https://shop.hak5.org/)\n\n**NOTE, THIS IS ALL FOR EDUCATIONAL PURPOSES ONLY**\nI am not held liable for any misuse of this script!\n\n## Installation\n\nTo install the Payload, first you will need to install the [Pico-Ducky](https://github.com/dbisu/pico-ducky) [CircuitPython](https://circuitpython.org/) software.\n\n1.Download the `CircuitPython` [.uf2](https://circuitpython.org/board/raspberry_pi_pico/) file and install it on your Pico.\n\n2.Then you can download the `adafruit-circuitpython-bundle-7.x-mpy-YYYYMMDD.zip`\nExtract the `adafruit_hid` folder from the `lib` folder of the downloaded file.\nPut the `adafruit.hid` folder inside of the Pico's `lib` folder.\n\n3. Then, save [this](https://raw.githubusercontent.com/dbisu/pico-ducky/main/duckyinpython.py) and save it as `code.py` and put it inside the Pico's root.\n\n4. Finally, download the [payload.dd](https://github.com/TeaPixl/Pico-NetCat-Reverse-Shell/blob/main/payload.dd) file and save it as payload.dd on your Pico's root.\n\nTo create your own Payloads, you can use the [USB-Rubber-Ducky-Wiki](https://github.com/hak5darren/USB-Rubber-Ducky/wiki/Duckyscript) by [Hak5](https://shop.hak5.org/) and create your own `payload.dd` files and upload them to the Pico.\n\nHere is a great video by [NetworkChuck](https://www.youtube.com/c/NetworkChuck/featured) showing how to install the `Rubber Ducky` [here](https://www.youtube.com/watch?v=e_f9p-_JWZw\u0026ab_channel=NetworkChuck).\n\n## Setup\n\nIn order to Reverse Shell a `Windows` Computer, you will want a [Linux](https://en.wikipedia.org/wiki/Linux) server listening to a specific port with `NetCat`\nYou will want to fill in the `IP-ADDRESS-HERE` and `PORT-HERE` with the port of your choice (preferably under 1000 to help avoid firewall detection) and the IP of your `Linux Server`\n\n### On the Linux Terminal\n\n```stty raw -echo; (stty size; cat) | nc -lvnp PORT-HERE```\nAnd replace the `PORT-HERE` with the port of your choice\n\n## Usage\nTake the Bad USB and plug it into a computer you own while the `Linux server` is listening,\nIt will disable `Windows Security` temporarily and execute the script quickly.\n\nThen it is safe to unplug your USB and go to your `Linux` machine\nYou should then have a fully interactive `Windows Terminal` with control over the computer!.\n\n## Known Issues\nOccasional unreliability and disconnection, cause is unknown\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteapixl%2Fpico-netcat-reverse-shell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteapixl%2Fpico-netcat-reverse-shell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteapixl%2Fpico-netcat-reverse-shell/lists"}