{"id":17929826,"url":"https://github.com/valdikss/tor-relay-scanner","last_synced_at":"2025-04-08T12:08:39.025Z","repository":{"id":43332812,"uuid":"447391526","full_name":"ValdikSS/tor-relay-scanner","owner":"ValdikSS","description":"Tor Relay availability checker, for using it as a bridge in countries with censorship","archived":false,"fork":false,"pushed_at":"2025-03-13T12:03:28.000Z","size":35,"stargazers_count":405,"open_issues_count":2,"forks_count":38,"subscribers_count":26,"default_branch":"main","last_synced_at":"2025-04-01T11:04:45.830Z","etag":null,"topics":["proxy-checker","proxy-scan","proxy-scanner","tor"],"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/ValdikSS.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":"2022-01-12T22:38:55.000Z","updated_at":"2025-03-31T19:09:17.000Z","dependencies_parsed_at":"2024-06-06T23:46:31.072Z","dependency_job_id":null,"html_url":"https://github.com/ValdikSS/tor-relay-scanner","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValdikSS%2Ftor-relay-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValdikSS%2Ftor-relay-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValdikSS%2Ftor-relay-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValdikSS%2Ftor-relay-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ValdikSS","download_url":"https://codeload.github.com/ValdikSS/tor-relay-scanner/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247838444,"owners_count":21004580,"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":["proxy-checker","proxy-scan","proxy-scanner","tor"],"created_at":"2024-10-28T21:10:39.948Z","updated_at":"2025-04-08T12:08:39.003Z","avatar_url":"https://github.com/ValdikSS.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Tor Relay Availability Checker\n==============================\n\nThis small script downloads all Tor Relay IP addresses from [onionoo.torproject.org](https://onionoo.torproject.org/) directly and via embedded proxies, and checks whether random Tor Relays are reachable from your Internet connection.\n\nIt could be used to find working Relay in a countries with Internet censorship and blocked Tor, and use it as Bridge to connect to Tor network, bypassing standard well-known nodes embedded into Tor code.\n\n## How to use with Tor Browser\n\nWorks on Windows and Linux. Not tested on macOS.\n\n1. Download latest version from [Releases](https://github.com/ValdikSS/tor-relay-scanner/releases) page.\n2. Put the file into Tor Browser's directory.\n3. **(Windows)**: Create a shortcut (link) to the file and append the following command line in shortcut settings: `-g 2 --timeout 3 --browser --start-browser`  \n   **(Linux)** : Create a shortcut to the file, launching it using `python3`, and append the following arguments: `-g 2 --timeout 3 --browser --start-browser`.  \n   The quick way to do this is to create a script with the following command:  \n   `echo -e '#!/bin/sh\\nexec python3' ./tor-relay-scanner-*.pyz '-g 2 --timeout 3 --browser --start-browser' \u003e run.sh \u0026\u0026 chmod +x run.sh`\n4. From now on, launch Tor Browser using the shortcut you've created in step 3. It will scan for reachable Relays, add it to Tor Browser configuration file (prefs.js), and launch the browser.\n\n\n## How to use with Tor (daemon)\n\nThis utility is capable of generating `torrc` configuration file containing Bridge information. Launch it with the following arguments:\n\n`--torrc --outfile /etc/tor/bridges.conf`\n\nAnd append:\n\n`%include /etc/tor/bridges.conf`\n\nto the end of `/etc/tor/torrc` file to make Tor daemon load it.\n\n\n## How to use as a standalone tool\n\n**Windows**: download ***.exe** file from [Releases](https://github.com/ValdikSS/tor-relay-scanner/releases) and run it in console (`start → cmd`)\n\n**Linux \u0026 macOS**: download ***.pyz** file from [Releases](https://github.com/ValdikSS/tor-relay-scanner/releases) and run it with Python 3.7+:  \n`python3 tor-relay-scanner.pyz`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaldikss%2Ftor-relay-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaldikss%2Ftor-relay-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaldikss%2Ftor-relay-scanner/lists"}