{"id":24864803,"url":"https://github.com/hunthubspace/torwatch","last_synced_at":"2025-09-23T23:30:29.144Z","repository":{"id":246806899,"uuid":"822240989","full_name":"hunThubSpace/TorWatch","owner":"hunThubSpace","description":"TorWatch is a powerful bash script for monitoring the availability of websites through the Tor network. It manages IP address rotation, blocks IP addresses if the site is inaccessible, and logs activities for tracking events.","archived":false,"fork":false,"pushed_at":"2025-01-30T08:42:21.000Z","size":16,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T09:30:05.344Z","etag":null,"topics":["bash-scripting","bugbounty","exploit","penetration-testing","tor","web-penetration-testing"],"latest_commit_sha":null,"homepage":"https://www.hunthub.space","language":"Shell","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/hunThubSpace.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-06-30T17:15:54.000Z","updated_at":"2025-01-30T08:42:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"29403784-4f61-480c-ae21-8ebeb83160b6","html_url":"https://github.com/hunThubSpace/TorWatch","commit_stats":null,"previous_names":["hunthubspace/torwatch"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hunThubSpace%2FTorWatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hunThubSpace%2FTorWatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hunThubSpace%2FTorWatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hunThubSpace%2FTorWatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hunThubSpace","download_url":"https://codeload.github.com/hunThubSpace/TorWatch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245717586,"owners_count":20661140,"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":["bash-scripting","bugbounty","exploit","penetration-testing","tor","web-penetration-testing"],"created_at":"2025-01-31T23:55:56.837Z","updated_at":"2025-09-23T23:30:24.108Z","avatar_url":"https://github.com/hunThubSpace.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TorWatch\r\n\r\n**TorWatch** is a comprehensive bash script designed for monitoring the availability of websites through the Tor network. This tool not only checks if a website is accessible but also manages IP address rotation using Tor, blocks IP addresses if the site is inaccessible, and keeps detailed logs of activities to help you monitor events effectively. Whether you are a security enthusiast, a researcher, or simply someone interested in maintaining online privacy, **TorWatch** provides an efficient and automated solution for your website monitoring needs.\r\n\r\n## Features\r\n\r\n- **Monitor Website**: Continuously checks if the specified website is accessible via the Tor network.\r\n- **Manual IP Change**: Change the Tor exit node by pressing `c` (no need to press Enter).\r\n- **Automatic IP Blocking**: Blocks IP addresses when the site is down and logs these events.\r\n- **Logging**: Saves activity logs and blocked IPs to files within a directory named after the website.\r\n- **GeoIP Lookup**: Uses `geoiplookup` to find the geographic location of the current IP address.\r\n\r\n## Requirements\r\n\r\nBefore you start, ensure the following tools are installed on your system:\r\n\r\n- `figlet` – For creating ASCII art text\r\n- `toilet` – For additional text fonts\r\n- `geoiplookup` – For IP geolocation\r\n- `tor` – For anonymous browsing\r\n\r\nIf any of these tools are missing, the script will attempt to install them automatically.\r\n\r\n## Installation\r\n\r\n### Clone the Repository\r\n\r\nTo get started, clone the repository using the following command:\r\n\r\n```bash\r\ngit clone https://github.com/hunThubSpace/TorWatch.git\r\ncd TorWatch\r\n```\r\n\r\n### Make the Script Executable\r\n\r\nNext, make the script executable:\r\n\r\n```bash\r\nchmod +x torwatch.sh\r\n```\r\n\r\n## How to Use\r\n\r\n### Start the Script\r\n\r\nRun the script with the domain of the website you want to monitor:\r\n\r\n```bash\r\n./torwatch.sh \u003cwebsite\u003e\r\n```\r\n\r\nReplace `\u003cwebsite\u003e` with the domain name of the site you wish to monitor (e.g., `example.com`, not `https://example.com`).\r\n\r\n### Manual IP Change\r\n\r\nTo manually change the Tor exit node:\r\n\r\n- Press **`c`** (without pressing Enter). The script will automatically restart Tor and change the IP address.\r\n\r\n### View Logs\r\n\r\nThe script generates two files for logging:\r\n\r\n- **Activity Log**: Located in `\u003cwebsite\u003e/\u003cwebsite\u003e.log`.\r\n- **Blocked IPs**: Stored in `\u003cwebsite\u003e/\u003cwebsite\u003e.blocked.txt`.\r\n\r\nExample:\r\n\r\n```text\r\nexample.com/example.com.log\r\nexample.com/example.com.blocked.txt\r\n```\r\n\r\n### Check Blocked IPs\r\n\r\nThe file `\u003cwebsite\u003e/\u003cwebsite\u003e.blocked.txt` contains a list of blocked IP addresses along with their geographic locations.\r\n\r\n## Troubleshooting\r\n\r\nHere are some common issues and solutions:\r\n\r\n- **`geoiplookup` Command Issues**: Ensure `geoip-bin` is installed correctly. You can install it using:\r\n\r\n    ```bash\r\n    sudo apt-get install geoip-bin\r\n    ```\r\n\r\n- **Tor Service Issues**: Make sure Tor is properly installed and can be started with the following commands:\r\n\r\n    ```bash\r\n    sudo systemctl start tor\r\n    sudo systemctl enable tor\r\n    ```\r\n\r\nIf you continue to encounter issues, check the logs in `\u003cwebsite\u003e/\u003cwebsite\u003e.log` for more details.\r\n\r\n## Demo\r\n\r\nHere’s a quick demo of how `TorWatch` works:\r\n\r\n\r\nhttps://github.com/hunThubSpace/TorWatch/assets/49031710/6bfab2d2-8915-467a-8a9b-670835a6e3e2\r\n\r\n\r\n\r\n\r\n\r\n### Example Command\r\n\r\n```bash\r\n./torwatch.sh example.com\r\n```\r\n\r\n### Example Output\r\n\r\n```text\r\n./torwatch example.com\r\n\r\n[*] Site https://example.com is accessible through Tor. Current IP: X.X.X.X (country)\r\n```\r\n\r\n### Manual IP Change\r\n\r\nWhen pressing `c`, the output will show:\r\n\r\n```text\r\n[*] Manually IP changed\r\n```\r\n\r\n### Blocked IP Example\r\n\r\nIf `example.com` is down, the script will log:\r\n\r\n```text\r\n[*] Site https://www.google.com returned status code 500. Blocking IP: 192.168.1.1 [Somewhere]\r\n```\r\n\r\n### Log Files\r\n\r\n**`example.com/example.com.log`** might contain entries like:\r\n\r\n```text\r\n2024-06-30 14:20:01 - Site https://example.com is accessible through Tor. Current IP: 127.0.0.1 [Somewhere]\r\n2024-06-30 14:25:01 - Site https://example.com returned status code 500. Blocking IP: 192.168.1.1 [Somewhere]\r\n```\r\n\r\n**`example.com/example.com.blocked.txt`** might contain entries like:\r\n\r\n```text\r\n192.168.1.1 - Somewhere\r\n```\r\n## Notes\r\n\r\n- Ensure you have the necessary permissions to manage the Tor service and install packages.\r\n- Use responsibly and adhere to the terms of service of the websites you are monitoring.\r\n- Modify the script as needed to fit your specific use case.\r\n\r\n## Acknowledgements\r\n\r\n- Thanks to [The Tor Project](https://www.torproject.org/) for their work in promoting online privacy.\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhunthubspace%2Ftorwatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhunthubspace%2Ftorwatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhunthubspace%2Ftorwatch/lists"}