Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > alt.comp.os.windows-10 > #197502
| From | Maria Sophia <mariasophia@comprehension.com> |
|---|---|
| Newsgroups | alt.comp.os.windows-10, alt.comp.software.firefox, alt.comp.microsoft.windows |
| Subject | Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes |
| Date | 2026-11-09 10:36 -0400 |
| Organization | BWH Usenet Archive (https://usenet.blueworldhosting.com) |
| Message-ID | <11cslog$2dq5$1@nnrp.usenet.blueworldhosting.com> (permalink) |
| References | <11cd4bm$2j2k$1@nnrp.usenet.blueworldhosting.com> |
Cross-posted to 3 groups.
Maria Sophia wrote:
> PSA: Setting the Windows Firefox Tor browser to use USA exit nodes
Below is portable code that should work on all the major platforms
(Linux/macOS/Windows) to choose per-profile FF Tor browser exit nodes.
I started this project five effort-hours ago assuming it would only
take a few minutes, so I used PowerShell at first, but to leverage
the effort to as many people as possible, which I am won't to do,
I expended another hour to port to Python and then to all platforms.
I tested the code below ONLY on Windows 10, so if someone can test
it on macOS and/or Linux, that would be very useful for the community.
Everything we do, is for everyone to benefit from.
That's how we're wired.
#!/usr/bin/env python3
# ---------------------------------------------------------------------
# torset.py
# Manually set known-good Tor exit nodes for specific web-login profiles
# ---------------------------------------------------------------------
# Usage notes:
# 1. Obtain a set of desired known-to-be-working US Tor exit relays:
# https://metrics.torproject.org/rs.html#search/country:us%20flag:exit
# For example:
# "$688604204AF0C0473DFFA8CD2E186D1EEAEE6916"
# "$B8FA90A8B7DA9B90A09AA04CD2E81E263AA8DA4C"
# "$BD610AAEAE179EC259B022A178A75C70042407FB"
# "$9C7B1DB2C5520B21E181EB945A01E9ABA42654A2"
# 2. Enter their fingerprints in the profile definitions, e.g.,
# Profile 1 (gmail)
# "$688604204AF0C0473DFFA8CD2E186D1EEAEE6916"
# "$B8FA90A8B7DA9B90A09AA04CD2E81E263AA8DA4C"
# Profile 2 (protonmail)
# "$BD610AAEAE179EC259B022A178A75C70042407FB"
# Profile 3 (facebook)
# "$9C7B1DB2C5520B21E181EB945A01E9ABA42654A2"
# 3. Run this script, which cleans stale sessions before starting
# Tor and then provides a choice of pre-selected exit nodes
# Note: Due to Firefox Tor browser complexities, allow Tor a bit of
# time to establish new circuits and then make sure to manually
# verify the exit relay and exit IP before logging in
# ---------------------------------------------------------------------
# v2p9 20261109 Added sys.platform support for macOS and Linux paths
# v2p8 20261109 Reverted profile exit nodes back to original configurations
# v2p7 20261108 Converted native batch/PowerShell implementation to Python
# v2p6 20261108 Improved documentation in terms of technical accuracy
# v2p5 20261108 Added new exit nodes and a profile configuration check
# v2p4 20261108 Handled stale process cleanup cleanly in native batch
# v2p3 20261108 Added automated cleanup of stale Tor/Firefox instances
# v2p2 20261108 Added full bootstrap completion polling on cold start
# v2p1 20261108 Fixed $tcp variable scope in try/finally block
# v2p0 20261108 Added automated Tor Browser startup and port polling
# v1p9 20261108 Added ControlPort error handling and response validation
# v1p8 20261108 Cleaned up comments and clarified explanations
# v1p7 20261108 Identify general-purpose ckts and compare exit fingerprints
# v1p6 20261108 Display multi-line Tor circuit status via GETINFO
# v1p5 20261108 Request new Tor circuits after profile selection
# v1p4 20261108 Added multi-profile exit-node selection menu
# v1p3 20261108 Set Profile 1 ExitNodes (two fingerprints) via SETCONF
# v1p2 20261108 Added GETINFO status/bootstrap-phase
# v1p1 20261108 Retrieve current ExitNodes configuration via GETCONF
# v1p0 20261108 Tested Tor ControlPort via TCP cookie authentication
# ---------------------------------------------------------------------
# See also...
# Forces a new working Tor exit node:
# <https://github.com/gmolop/Tor-ExitNode-changer/>
# <https://github.com/hevnsnt/IPChanger>
# <https://gist.github.com/kirelagin/9667900>
# Interacts with Tor using the Python stem library:
# <https://pypi.org/project/stem/> <https://stem.torproject.org/>
# <https://github.com/torproject/stem>
# Command-line Tor interaction and Nyx monitor:
# <https://nyx.torproject.org/> <https://github.com/torproject/nyx>
# Configures Tor using a GUI (Windows only):
# <https://github.com/abysshint/tor-control-panel/>
# ---------------------------------------------------------------------
# Summary:
# 1. Present a multi-profile selection menu allowing the user to choose
# between predefined exit-node configurations (or quit with Q).
# 2. Terminate any stale or running instances of Firefox Tor Browser
# to ensure a clean starting environment.
# 3. Launch the Firefox Tor Browser executable automatically if it is
# not currently running on the system.
# 4. Poll local TCP port 9151 and monitor for the existence of Tor's
# control authentication cookie file.
# 5. Open a local TCP socket connection to Tor's ControlPort
# (127.0.0.1:9151) once it becomes available.
# 6. Authenticate the control session securely using the binary bytes
# read from Tor's local control_auth_cookie.
# 7. Poll Tor's bootstrap status via GETINFO until the bootstrap-phase
# reports 100% completion.
# 8. Apply the user's selected profile fingerprints to Tor's configuration
# using the SETCONF ExitNodes command.
# 9. Issue a SIGNAL NEWNYM command to force Tor to discard old circuits
# and build new ones using the designated exit nodes.
# 10. Verify that the active ExitNodes configuration matches the expected
# profile fingerprints.
# 11. Query active circuits (GETINFO circuit-status), parse their exit node
# fingerprints and compare them against the profile whitelist.
# 12. Output clear verification results to the user console and pause
# before exiting, leaving the configured browser ready for secure use.
# ---------------------------------------------------------------------
import os
import socket
import subprocess
import sys
import time
from pathlib import Path
# --- Configuration & Cross-Platform Paths ---
if sys.platform == "win32":
COOKIE_PATH = Path(
r"C:\app\browser\tor\Tor Browser\Browser\TorBrowser\Data\Tor\control_auth_cookie"
)
TOR_EXE = Path(r"C:\app\browser\tor\Tor Browser\Browser\firefox.exe")
KILL_CMD = ["taskkill", "/f", "/im", "firefox.exe"]
elif sys.platform == "darwin": # macOS
TOR_EXE = Path.home() / "Applications" / "TorBrowser.app" / "Contents" / "MacOS" / "firefox"
if not TOR_EXE.is_file():
TOR_EXE = Path("/Applications/TorBrowser.app/Contents/MacOS/firefox")
COOKIE_PATH = Path.home() / "Library" / "Application Support" / "TorBrowser-Data" / "Tor" / "control_auth_cookie"
KILL_CMD = ["pkill", "-f", "torbrowser"]
else: # Linux and other Unix-likes
base_linux = Path.home() / ".local" / "share" / "torbrowser" / "tor" / "x86_64" / "tor-browser"
TOR_EXE = base_linux / "Browser" / "firefox"
COOKIE_PATH = base_linux / "Browser" / "TorBrowser" / "Data" / "Tor" / "control_auth_cookie"
KILL_CMD = ["pkill", "-f", "tor-browser"]
CONTROL_PORT = 9151
# Define selectable profiles with your original exit node fingerprints
PROFILES = {
"1": {
"name": "Profile 1",
"exit_nodes": (
"$688604204AF0C0473DFFA8CD2E186D1EEAEE6916,"
"$B8FA90A8B7DA9B90A09AA04CD2E81E263AA8DA4C"
),
},
"2": {
"name": "Profile 2",
"exit_nodes": "$BD610AAEAE179EC259B022A178A75C70042407FB",
},
"3": {
"name": "Profile 3",
"exit_nodes": "$9C7B1DB2C5520B21E181EB945A01E9ABA42654A2",
},
}
def main():
# Step 1: Profile Selection Menu
print("----------------------------------------")
print(" Tor exit node selector ")
print("----------------------------------------")
print()
print(" 1 for Profile 1")
print(" 2 for Profile 2")
print(" 3 for Profile 3")
print(" Q to Quit")
print()
choice = input("Select profile [1,2,3] or Q to quit: ").strip().upper()
if choice == "Q" or choice not in PROFILES:
print("Exiting.")
sys.exit(0)
profile = PROFILES[choice]
print(f"\nSetting {profile['name']}...")
# Step 2: Clean up any stale or running Tor/Firefox instances
print("Ensuring clean state by stopping any existing Tor instances...")
try:
subprocess.run(
KILL_CMD,
stdout=subprocess.DEVNULL,
stderr=subprocess.DEVNULL,
)
except Exception:
pass
time.sleep(2)
# Steps 3 & 4: Launch browser if needed and wait for ControlPort & cookie
if not COOKIE_PATH.is_file():
print("Tor Browser is not running. Starting Tor Browser automatically...")
if not TOR_EXE.is_file():
print(f"ERROR: Tor Browser executable not found at: {TOR_EXE}")
sys.exit(1)
subprocess.Popen([str(TOR_EXE)])
print("Waiting for Tor Browser to initialize and open ControlPort (9151)...")
start_time = time.time()
ready = False
while time.time() - start_time < 45:
if COOKIE_PATH.is_file():
try:
test_sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
test_sock.settimeout(2)
test_sock.connect(("127.0.0.1", CONTROL_PORT))
test_sock.close()
ready = True
break
except (socket.error, OSError):
pass
time.sleep(2)
if not ready:
print(
"ERROR: Timed out waiting for Tor Browser to start and open ControlPort"
" 9151."
)
sys.exit(1)
print("Tor Browser port is open.")
# Step 6: Read authentication cookie bytes
try:
cookie_bytes = COOKIE_PATH.read_bytes()
cookie_hex = cookie_bytes.hex().upper()
except Exception as e:
print(f"ERROR: Failed to read control authentication cookie: {e}")
sys.exit(1)
# Helper functions for Tor Control Protocol
def read_tor_reply(sock_file):
lines = []
while True:
line = sock_file.readline()
if not line:
raise RuntimeError("Tor closed the ControlPort connection unexpectedly.")
decoded = line.decode("utf-8", errors="ignore").rstrip("\r\n")
lines.append(decoded)
if decoded.startswith("250+"):
while True:
data_line = sock_file.readline()
if not data_line:
raise RuntimeError(
"Tor closed the connection during a data response."
)
d_decoded = data_line.decode("utf-8", errors="ignore").rstrip(
"\r\n"
)
lines.append(d_decoded)
if d_decoded == ".":
break
continue
if len(decoded) >= 4 and decoded[3] == "-":
continue
break
return lines
def send_command(sock_file, command):
sock_file.write((command + "\r\n").encode("utf-8"))
sock_file.flush()
reply = read_tor_reply(sock_file)
if not reply or not reply[0].startswith("250"):
raise RuntimeError(f"Tor rejected command: {command} -- {' '.join(reply)}")
return reply
# Step 5: Connect to ControlPort
stream = None
s = None
try:
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.settimeout(15)
s.connect(("127.0.0.1", CONTROL_PORT))
stream = s.makefile("rwb")
# Authenticate session
auth_reply = send_command(stream, f"AUTHENTICATE {cookie_hex}")
print(f"Authentication: {auth_reply[0]}")
# Step 7: Wait for Tor bootstrap completion (100%)
print("Waiting for Tor bootstrap to complete...")
bootstrap_complete = False
b_start = time.time()
while time.time() - b_start < 60:
try:
bootstrap_reply = send_command(stream, "GETINFO status/bootstrap-phase")
for line in bootstrap_reply:
if "PROGRESS=100" in line:
bootstrap_complete = True
break
if bootstrap_complete:
break
except Exception:
pass
time.sleep(2)
if not bootstrap_complete:
raise RuntimeError("Timed out waiting for Tor to finish bootstrapping.")
print("Tor bootstrap complete (100%).")
# Step 8: Apply selected profile ExitNodes via SETCONF
config_reply = send_command(stream, "GETCONF ExitNodes")
print(f"Exit configuration: {' '.join(config_reply)}")
setconf_reply = send_command(
stream, f"SETCONF ExitNodes={profile['exit_nodes']}"
)
print(f"SETCONF response: {setconf_reply[-1]}")
# Step 9: Signal NEWNYM to clear circuits and build new ones
newnym_reply = send_command(stream, "SIGNAL NEWNYM")
print(f"NEWNYM response: {newnym_reply[-1]}")
time.sleep(3)
# Step 10: Verify new ExitNodes configuration matches expected
config_reply = send_command(stream, "GETCONF ExitNodes")
print(f"New exit configuration: {' '.join(config_reply)}")
actual_line = None
for item in config_reply:
if item.startswith("250 ExitNodes="):
actual_line = item
break
if not actual_line:
raise RuntimeError("Could not verify the new ExitNodes configuration.")
actual_text = actual_line.replace("250 ExitNodes=", "")
actual_nodes = [
fp.strip().lstrip("$").upper() for fp in actual_text.split(",") if fp
]
expected_nodes = [
fp.strip().lstrip("$").upper()
for fp in profile["exit_nodes"].split(",")
if fp
]
if set(actual_nodes) != set(expected_nodes):
raise RuntimeError("ExitNodes verification failed: fingerprint mismatch.")
print("ExitNodes verification: Match")
allowed = {fp: True for fp in expected_nodes}
# Step 11: Inspect circuit-status and compare exit fingerprints
circuit_reply = send_command(stream, "GETINFO circuit-status")
print("\nGeneral-purpose circuits")
print("-------------------------")
found = False
for line in circuit_reply:
if "BUILT" not in line or "PURPOSE=GENERAL" not in line:
continue
fields = line.split()
if len(fields) < 3:
continue
circuit_id = fields[0]
hops = fields[2].split(",")
last_hop = hops[-1].split("~")[0].lstrip("$").upper()
found = True
print(f"\nCircuit: {circuit_id}")
print(f"Exit fingerprint: {last_hop}")
if last_hop in allowed:
print("Profile comparison: Match")
else:
print("Profile comparison: Not in profile")
if not found:
print("No built general-purpose circuits found.")
print("\nCircuit inspection complete.")
print("Tor control session completed successfully.")
except Exception as e:
print(f"\nError: {e}", file=sys.stderr)
sys.exit(1)
finally:
if stream:
try:
stream.close()
except Exception:
pass
if s:
try:
s.close()
except Exception:
pass
# Step 12: Output final success message and pause before exit
print("\ntorset completed successfully.")
input("Press Enter to continue . . . ")
if __name__ == "__main__":
main()
# ---------------------------------------------------------------------
# end of torset.py
# ---------------------------------------------------------------------
--
On Usenet, a good suggestion can make everyone's solution a little better.
Back to alt.comp.os.windows-10 | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread
PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-03 13:07 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-04 12:48 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-07 23:08 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-07 23:58 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-08 03:45 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Simon <invalid@invalid.invalid> - 2026-11-08 04:00 +0000
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-08 02:13 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes "Carlos E.R." <robin_listas@es.invalid> - 2026-11-08 15:14 +0100
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-08 13:42 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Paul <nospam@needed.invalid> - 2026-11-08 04:22 -0500
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-08 13:14 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes "Carlos E.R." <robin_listas@es.invalid> - 2026-11-08 15:19 +0100
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-08 13:06 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-08 14:49 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-09 10:36 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-10 00:00 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-10 12:52 -0400
Re: PSA: Setting the Windows Firefox Tor browser to use USA exit nodes Maria Sophia <mariasophia@comprehension.com> - 2026-11-10 16:16 -0400
csiph-web