Updates since v1.0.0:

• Fix scanning for the latest set of servers in the list (@wildekat)

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

Updates since v0.0.9:

• Add --preferred-country option to sort relays by country list
• Fix for -p option: do not rewrite previous records

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

More information: Доступ в Tor из России — Простые методы доступа в сеть Tor в условиях блокировки в РФ

Updates since v0.0.8:

• Added github.com and bitbucket.org onionoo mirros
• Other small fixes

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

More information: Доступ в Tor из России — Простые методы доступа в сеть Tor в условиях блокировки в РФ

Updates since v0.0.7:

• Non-working CORS proxies hosted on Heroku are removed
• Added -p port scanning option, to scan relays only of specified ports
• Added --url alternative onionoo relay list option

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

More information: Доступ в Tor из России — Простые методы доступа в сеть Tor в условиях блокировки в РФ

Updates since v0.0.6:

• Fix for Bridge lines and prefs.js configuration for IPv4+IPv6 bridges

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

Updates since v0.0.5:

• New --browser option, which inserts bridge data to prefs.js Tor Browser configuration file
• New --start-browser option which launch Tor Browser after scanning process is done (only Windows and Linux for now)

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

Updates since v0.0.4:

• Fix scanning timeout value
• Add proxy support for onionoo data
• Minor bug fixes

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

Updates since v0.0.3:

• Command-line arguments for working relay goal, timeout and number of scanned relays concurrently (courtesy of @gp2112)
• New --outfile and --torrc options to output working relays into external text file in plain or torrc configuration format
• Minor text output improvements

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

Updates since v0.0.2:

• As more and more relays are getting banned, check all relays until working are found.
• Minor text output improvements

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz

Android: download Termux, install python with pkg install python3, follow Linux steps.

Updates since v0.0.1:

• Use public CORS proxies (as proxies) to access onionoo in case of its unreachability.
• Test 30 proxies concurrently up to 5 times to grab 5 working relays

Windows: download *.exe file and run it in console (start → cmd)

Linux & macOS: download *.pyz file and run it with Python 3.7+:
python3 tor-relay-scanner.pyz