{"id":17649092,"url":"https://github.com/996refuse/esp8266socks","last_synced_at":"2026-07-04T17:31:29.480Z","repository":{"id":240547415,"uuid":"800955670","full_name":"996refuse/esp8266socks","owner":"996refuse","description":"connect your PC to WIFI network by esp8266","archived":false,"fork":false,"pushed_at":"2024-05-27T16:11:59.000Z","size":30489,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T08:43:05.824Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/996refuse.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-15T10:17:54.000Z","updated_at":"2024-05-27T16:12:02.000Z","dependencies_parsed_at":"2024-05-19T17:45:01.072Z","dependency_job_id":"b576f097-7fd3-427e-9f6b-69a1acb0e941","html_url":"https://github.com/996refuse/esp8266socks","commit_stats":null,"previous_names":["996refuse/esp8266socks"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/996refuse/esp8266socks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/996refuse%2Fesp8266socks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/996refuse%2Fesp8266socks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/996refuse%2Fesp8266socks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/996refuse%2Fesp8266socks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/996refuse","download_url":"https://codeload.github.com/996refuse/esp8266socks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/996refuse%2Fesp8266socks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35130722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-04T02:00:05.987Z","response_time":113,"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":[],"created_at":"2024-10-23T11:24:01.140Z","updated_at":"2026-07-04T17:31:29.456Z","avatar_url":"https://github.com/996refuse.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# esp8266socks\nconnect your PC to WIFI network by esp8266\n\n![](https://raw.githubusercontent.com/996refuse/esp8266socks/master/demo.gif)\n\n### hardware\n\npc -\u003e USB Serial UART Converter -\u003e esp01\n\nnotes:\n\n1. chips on usb serial converter both pl2303, ch340 or ft232 are tested working fine. The converter's Gnd should wire to esp01's Gnd, otherwise the serial output is garbled.\n2. 3.3v power supply to esp01 is important, esp01's unstable issue is mostly possibly caused by the power supply\n3. require good heat dissipation on esp8266 chip, when the wifi is turning on, the power consumption is becoming high and temperature is becoming high, it's very possible lead to stuck.\n\n### Internet speed on esp8266\n\nlet's take 115200 baud rate as an example, it's the default uart serial config on esp8266.\n\n```\n115200bit/s = 14.0625kb/s\n```\n\nso in theory, the speed can never be faster than 14kb/s. today's most modern web page is about 5mb, it costs more than 6 minutes to load it.\n\n### usage\n\n```sh\n# install dependancy package\npip install -r requirements.txt\n\npython main.py --host \u003cip address\u003e --port \u003cport\u003e --serial /dev/tty\u003cserial port\u003e --ssid \u003cssid\u003e --password \u003cpassword\u003e\n```\n\n### software structure\n\n```\n     -------------                                                                            --------------\n    |             | \u003c- connect                                                    connect -\u003e |              |   listen\n    | esp8266wifi | \u003c-   close    linkid \u003c== esp8266_linkid_socks_map ==\u003e sock    close   -\u003e | socks5server | ========== socks5 proxy\n    |             | \u003c-    recv                                                    revc    -\u003e |              |\n    |             | \u003c-    send                                                    send    -\u003e |              |\n     -------------                                                                            --------------\n           ||\n           ||\n           || at command\n           ||\n           ||\n       ----------\n      | pyserial |\n       ----------\n```\n\n### annoying hardware/firmware issues\n\n#### *busy p...*\n\nwhen select timeout is too long (more than 1s), all requests burst at one moment. cause esp8266 enter \"bush p...\" state.\n\n#### *busy s...*\n\nstill can't find the root cause\n\n### license\n\nWTFPL http://www.wtfpl.net/\n\n### donate\n\n![image](https://raw.githubusercontent.com/996refuse/esp8266socks/master/donate.png)\n\n### contact me\n\n![image](https://raw.githubusercontent.com/996refuse/esp8266socks/master/wechat.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F996refuse%2Fesp8266socks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F996refuse%2Fesp8266socks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F996refuse%2Fesp8266socks/lists"}