Skip to content

README.md

Latest commit

 

History

History
35 lines (28 loc) · 1.41 KB

README.md

File metadata and controls

35 lines (28 loc) · 1.41 KB

Tor Checker

Usage

python3 tor_checker.py -i <IP>            # or --ip <IP>
python3 tor_checker.py -i <IP> -t <DATE>  # or --time <DATE>

Example (historic):

python3 tor_checker.py -i 1.2.3.4 -t 2025-11-03

Behavior / output

  • The script performs two kinds of checks:
    • Realtime (no -t/--time): queries Onionoo for current relay/bridge info.
    • Historic (with -t/--time): queries ExoneraTor for the given date.
  • The -t / --time option expects a date in YYYY-MM-DD format and must be older than yesterday (the script will exit if you give today or yesterday).
  • Output: the script prints a single integer at the end:
    • 1 means the IP was identified as Tor-related for the chosen check.
    • 0 means it was not.
  • Note: Onionoo (realtime) may also print human-readable lines such as " is a Tor relay, and currently online" before the final 0/1 is printed.

Options

  • -i, --ip Target IPv4 address (required).
  • -t, --time Date for historic check (optional). Use YYYY-MM-DD and pick a date older than yesterday.
  • -h, --help Show argparse help (if implemented).

Short note

The script prints 0 or 1 as the final result; the README now matches the actual flags and behavior. If you want, I can add an argument-parsing help text or make the script print a clearer multi-field summary instead of a lone integer.