https://github.com/titiky441/torrelayscannercs
C# implementation of tor-relay-scanner by ValdikSS
https://github.com/titiky441/torrelayscannercs
censorship-circumvention tor tor-relays
Last synced: about 2 months ago
JSON representation
C# implementation of tor-relay-scanner by ValdikSS
- Host: GitHub
- URL: https://github.com/titiky441/torrelayscannercs
- Owner: TiTiKy441
- Created: 2025-02-21T00:15:18.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-07-03T17:10:43.000Z (12 months ago)
- Last Synced: 2025-07-03T18:26:33.403Z (12 months ago)
- Topics: censorship-circumvention, tor, tor-relays
- Language: C#
- Homepage:
- Size: 51.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TorRelayScannerCS
## C# implementation of [Tor-relay-scanner by ValdikSS](https://github.com/ValdikSS/tor-relay-scanner)
Attempts to download information about all tor relays, from official site and through mirrors embedded in the code
Attempts to ping them and find reachable ones to be used as bridges to access Tor network even in banned regions
## Supported platforms
Currently tested only on Windows 10 x64.
Basic functionality should be available on Linux, tor location autodetection probably doesnt work
If anyone can test it on Linux, would be much appreciated
## How to use
```
Description:
Automatically retrieves information about tor relays and scans them for reachability
Usage:
TorRelayScannerCS [options]
Options:
-n The number of concurrent relays tested [default: 50]
-g Test until at least this number of working relays are found [default: 3]
-c Include only following countries for testing, exclude by adding '-'. Example: nl,de (only netherlands and germany) Example exclude: -nl (not netherlands) []
--timeout Socket connection timeout in milliseconds [default: 500]
-o Output reachable relays to file []
--torrc Output/install reachable relays in torrc format [default: False]
--proxy Set proxy for onionoo information download. Format: http://user:pass@host:port; socks5h://user:pass@host:port []
--url Preferred alternative URL for onionoo relay list. Could be used multiple times. []
-p
Scan for relays running on specified port number. Could be used multiple times. []
--browser-location Tor browser executable location []
--not-install-bridges Not install bridges into Tor browser [default: False]
--not-start-browser Not launch browser after scanning [default: False]
--use-outdated Use already existing outdated relay information [default: False]
--force-update Update relay information file regarding if it is outdated or not [default: False]
--version Show version information
-?, -h, --help Show help and usage information
```
Note: browser-location is exptected to contain an executable inside, by default on windows is usually: `C:\Users\user\Desktop\Tor Browser\Browser` (e.g `Tor Browser\Browser` in Desktop)
## Behaviour difference compared to original program
Downloaded relay info is saved into the file in the same directory as the program (`relay-info.json` file).
Program tries to use this already downloaded information first.
If information in the file is >=1 days older, program tries to download fresh copy.
If you wish to use already existing outdated file, add `--use-outdated` flag.
Different logging format.
Browser location is not required, program tries to auto-detect it by enumerating special paths and (only on windows) searching for tor browser launcher key in registry.
`install-bridges` and `start-browser` turned to `--not-install-bridges` and `--not-start-browser`.
behaviour by default install bridges and start the browser.
added `--force-update` flag to update relays information regarding if it's outdated or not
`-c` argument doesnt support preffered countries, only include or exclude.