{"id":22665224,"url":"https://github.com/volkansah/tor-scapy-application","last_synced_at":"2025-08-17T16:47:56.707Z","repository":{"id":263480965,"uuid":"805722793","full_name":"VolkanSah/Tor-Scapy-Application","owner":"VolkanSah","description":"This project is a simple example of using Stem and Scapy together to create an anonymized network analysis tool. The application can connect to a running Tor process or start a new one, send network packets through the Tor network, and rotate identities.","archived":false,"fork":false,"pushed_at":"2024-11-18T18:56:52.000Z","size":17,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T10:55:46.197Z","etag":null,"topics":["admins","analytics","defense","hack","hacking","offensive","python","scapy","script","security","stem","tor","wardrive"],"latest_commit_sha":null,"homepage":"","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/VolkanSah.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["volkansah"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"custom":null}},"created_at":"2024-05-25T09:27:47.000Z","updated_at":"2024-11-18T18:56:56.000Z","dependencies_parsed_at":"2024-11-19T05:36:21.452Z","dependency_job_id":null,"html_url":"https://github.com/VolkanSah/Tor-Scapy-Application","commit_stats":null,"previous_names":["volkansah/tor-scapy-application"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VolkanSah%2FTor-Scapy-Application","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VolkanSah%2FTor-Scapy-Application/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VolkanSah%2FTor-Scapy-Application/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VolkanSah%2FTor-Scapy-Application/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VolkanSah","download_url":"https://codeload.github.com/VolkanSah/Tor-Scapy-Application/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246168097,"owners_count":20734389,"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":["admins","analytics","defense","hack","hacking","offensive","python","scapy","script","security","stem","tor","wardrive"],"created_at":"2024-12-09T13:29:32.950Z","updated_at":"2025-08-17T16:47:56.684Z","avatar_url":"https://github.com/VolkanSah.png","language":"Python","funding_links":["https://github.com/sponsors/volkansah"],"categories":[],"sub_categories":[],"readme":"# Tor Scapy Application (TSA)\n\n**Tor Scapy Application** is a simple yet powerful tool that combines [Stem](https://stem.torproject.org/) and [Scapy](https://scapy.net/) to send network packets anonymously through the Tor network. It can start a Tor process, connect to it, and rotate your Tor identity on demand. Perfect for network analysis, testing, or just playing with Tor + Python magic.\n\n---\n\n## Features\n\n* Launch a Tor process programmatically\n* Connect to an existing Tor controller\n* Rotate Tor identities on the fly (NEWNYM signal)\n* Send ICMP packets via Tor SOCKS5 proxy\n* Easy to customize for your own network tasks\n\n---\n\n## Requirements\n\n* Python 3.x\n* [Stem](https://stem.torproject.org/) Python library\n* [Scapy](https://scapy.net/) Python library\n* Tor installed and running (or launched via script)\n\n---\n\n## Installation\n\n1. Install Python 3.x:\n   [https://www.python.org/downloads/](https://www.python.org/downloads/)\n\n2. Install required Python packages:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n   *(Make sure requirements.txt includes `stem` and `scapy`)*\n\n3. Install and start Tor:\n\n   * Download from [https://www.torproject.org/](https://www.torproject.org/)\n   * Or let the script launch Tor automatically\n\n---\n\n## Usage\n\nRun the app:\n\n```bash\npython tor_scapy_app.py\n```\n\nor\n\n```bash\npython3 tor_scapy_app.py\n```\n\nBy default, it sends an ICMP (ping) packet to `8.8.8.8` through the Tor network and shows the response.\n\n\n\n## Customization\n\n* Modify `start_tor_process()` to add your Tor configs (e.g., ports, bridges)\n* Change the `destination_ip` variable in `__main__` to target a different host\n* Extend `send_packet_via_tor()` to send other packet types supported by Scapy\n\n\n\n## Notes\n\n* The script requires the Tor control port (`9051` by default) to be enabled and accessible\n* Identity change takes a few seconds (`time.sleep(5)` after NEWNYM signal)\n* Running with root/admin privileges may be needed for sending raw packets\n* Use responsibly and respect network policies and laws\n\n\n## Credits \u0026 Support\nVisit [https://volkansah.github.io](https://volkansah.github.io) for more projects\n\n\n## License\n\nThis project is licensed under the **MIT License** — do what you want, just keep it cool.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolkansah%2Ftor-scapy-application","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvolkansah%2Ftor-scapy-application","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolkansah%2Ftor-scapy-application/lists"}