{"id":18830910,"url":"https://github.com/alexlynd/esp8266-warshipping","last_synced_at":"2025-10-16T05:33:56.868Z","repository":{"id":60051717,"uuid":"525574878","full_name":"AlexLynd/ESP8266-WarShipping","owner":"AlexLynd","description":"Low-cost WarShipping with built-in geofencing, WiFi recon, and Rogue AP on the ESP8266","archived":false,"fork":false,"pushed_at":"2022-09-16T00:38:00.000Z","size":72,"stargazers_count":46,"open_issues_count":1,"forks_count":9,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-13T20:50:38.912Z","etag":null,"topics":["esp32","esp8266","reconnaissance","wardriving","warshipping","wifi-security"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexLynd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-08-16T23:36:02.000Z","updated_at":"2025-05-25T06:49:49.000Z","dependencies_parsed_at":"2022-09-25T17:22:40.690Z","dependency_job_id":null,"html_url":"https://github.com/AlexLynd/ESP8266-WarShipping","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AlexLynd/ESP8266-WarShipping","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexLynd%2FESP8266-WarShipping","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexLynd%2FESP8266-WarShipping/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexLynd%2FESP8266-WarShipping/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexLynd%2FESP8266-WarShipping/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexLynd","download_url":"https://codeload.github.com/AlexLynd/ESP8266-WarShipping/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexLynd%2FESP8266-WarShipping/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279159536,"owners_count":26116492,"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","status":"online","status_checked_at":"2025-10-16T02:00:06.019Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["esp32","esp8266","reconnaissance","wardriving","warshipping","wifi-security"],"created_at":"2024-11-08T01:51:18.608Z","updated_at":"2025-10-16T05:33:56.837Z","avatar_url":"https://github.com/AlexLynd.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESP8266 WarShipping\nLow-cost WarShipping proof-of-concept with built-in geofencing \u0026 WiFi recon on the ESP8266.\n\n## What is WarShipping?\nWarShipping involves mailing a physical package that delivers an attack payload to a victim.  Typically these attacks will target large companies by addressing the package to a non-existent recipient, and having the package run a wireless payload while sitting inside a mail center, until it's shipped back to the return address.  \n\n## WarShipping Proof-of-Concept\n\n### Components\nI wanted to show that a $5 payload could phish for user credentials and gather reconnaissance on a corporate network, so I used the following components: \n- ($2) [ESP8266 WiFi microcontroller]()\n- ($2) [LiPo charging circuit]()\n- ($6) [1800 mAh LiPo battery]()*  \n\u003csub\u003e*I ripped this out of a toy helicopter*\u003c/sub\u003e\n\n\n*insert image here*\n\nThe \"D1 Mini\" form factor makes these components stackable, but I soldered everything together to make it more stable for shipping.\n\n*insert image here*\n\n### Setup\nSetup video + guide coming soon!\n\n#### Building \u0026 flashing from source\n**To compile this tool from scratch, install `make` and `docker` on your machine.**\n```\nsudo apt install make docker\n```\n\n**Clone this GitHub repo \u0026 navigate to source**  \n```\ngit clone https://github.com/AlexLynd/ESP8266-WarShipping\ncd ESP8266-WarShipping/src\n```\n**Build only**  \n```\nsudo make build\n```  \n**Build \u0026 flash the ESP8266**  \n```\n# PORT parameter optional\n# update network triggers\n\nsudo make flash trigger-network=\u003cnetworkname\u003e home-network=\u003cnetworkname\u003e PORT=\u003cport\u003e\n```\n\n### Features\n- Low-power mode\n- Geofencing\n- Basic WiFi reconnaissance\n- Rogue AP for credential phishing\n- Known network detection\n- CSV logging\n\n### To-Do\n- CSV exports\n- Deep sleep\n- WiFi manager for cred setup\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexlynd%2Fesp8266-warshipping","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexlynd%2Fesp8266-warshipping","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexlynd%2Fesp8266-warshipping/lists"}