{"id":19646871,"url":"https://github.com/aleff-github/torwatchdog","last_synced_at":"2025-02-27T00:17:51.036Z","repository":{"id":235803084,"uuid":"791145638","full_name":"aleff-github/TorWatchdog","owner":"aleff-github","description":"Monitor the status of your Tor relays and receive alerts when relays go offline.","archived":false,"fork":false,"pushed_at":"2024-04-29T13:57:23.000Z","size":920,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-09T21:52:16.043Z","etag":null,"topics":["metrics","onionoo","relay","tor","tor-metrics","tor-nodes","tor-relay","tor-relay-node","tor-relay-operator","tor-relays","tor-watchdog","tor-weather","torwatchdog"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aleff-github.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":"2024-04-24T07:16:24.000Z","updated_at":"2024-05-08T06:19:07.000Z","dependencies_parsed_at":"2024-04-24T16:28:51.043Z","dependency_job_id":"ec51442a-980d-43b3-a89d-0131f1bfc3f1","html_url":"https://github.com/aleff-github/TorWatchdog","commit_stats":null,"previous_names":["aleff-github/torwatchdog"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aleff-github%2FTorWatchdog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aleff-github%2FTorWatchdog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aleff-github%2FTorWatchdog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aleff-github%2FTorWatchdog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aleff-github","download_url":"https://codeload.github.com/aleff-github/TorWatchdog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240953479,"owners_count":19884024,"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":["metrics","onionoo","relay","tor","tor-metrics","tor-nodes","tor-relay","tor-relay-node","tor-relay-operator","tor-relays","tor-watchdog","tor-weather","torwatchdog"],"created_at":"2024-11-11T14:41:09.244Z","updated_at":"2025-02-27T00:17:51.015Z","avatar_url":"https://github.com/aleff-github.png","language":"Python","readme":"# Tor Watchdog Bot\n\nTor Watchdog Bot is a Telegram bot designed to monitor the status of Tor relays and notify users when relays go offline.\n\n\u003e Currently, the bot is reported as reachable but not usable due to security reasons towards users. The currently active backend refers to the demo.py file and not the main.py file. Feel free to download, modify, test and use the published code, as it has been released under the GPLv3 license.\n\n\u003cimg src=\"assets/UNOFFICIAL.png\" width=\"150\"/\u003e\n\n## Features\n\n- **Relay Status Monitoring**: The bot regularly checks the status of Tor relays to ensure they are online.\n- **Alert Notifications**: Users receive instant notifications when one of their Tor relays goes offline.\n- **Simple Interface**: Easy-to-use commands make it simple for users to add, remove, and list Tor relays.\n\n![](assets/bot.gif)\n\n## Usage\n\nTo get started, simply [start the bot](https://t.me/TorWatchdogBot) and use the following commands (by clicking the buttons):\n\n- `/start`: Initialize the bot and register your Telegram ID.\n- `\"[+] Node\"`: Add a Tor relay to monitor. The bot will prompt you to enter the relay's fingerprint.\n- `\"[-] Node\"`: Remove a Tor relay from monitoring. The bot will prompt you to enter the relay's fingerprint.\n- `\"List Nodes\"`: List all Tor relays currently being monitored.\n- `\"Status Nodes\"`: Check the status of all monitored Tor relays.\n\n## Installation\n\n1. Clone this repository to your local machine:\n\n    ```bash\n    git clone https://github.com/aleff-github/TorWatchdog.git\n    ```\n\n2. Install the required Python packages:\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n3. Obtain a Telegram Bot Token from BotFather and replace `your_telegram_token_here` in `config.ini` with your token.\n\n4. Run the bot:\n\n    ```bash\n    python bot.py\n    ```\n\n## About\n\nTor Watchdog Bot was developed by Alessandro Greco (Aleff) and released under the GPLv3 license.\n\nFor any questions, feedback, or inquiries, feel free to contact via e-mail or Signal\n\nHappy Hacking! 🛡️\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faleff-github%2Ftorwatchdog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faleff-github%2Ftorwatchdog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faleff-github%2Ftorwatchdog/lists"}