@@ -8,39 +8,39 @@ state stays inside one folder, so you can copy or move it anywhere.
88## Layout
99
1010```
11- start-tor.exe double-click to start Tor and set the system proxy
12- data\ everything else lives here
13- tor.exe + DLLs, geoip, geoip6, transports (obfs4/snowflake/webtunnel)
14- torrc portable config (relative paths; sits next to tor.exe)
15- scripts\ launcher.ps1 (new identity / stop) + fetch-bridges.ps1
11+ start-tor.exe double-click to start; asks for a connection mode
12+ data\
13+ tor.exe + DLLs, geoip, geoip6, transports
14+ torrc.template base config (relative paths; sits next to tor.exe)
15+ torrc generated by start-tor.exe from the chosen mode
16+ bridges\ obfs4_tested.txt, webtunnel_tested.txt, vanilla_tested.txt
1617 data\ runtime state (cached consensus, keys, tor.log)
1718```
1819
1920## Usage
2021
21221 . Download the ` tor-win64-portable ` artifact from GitHub Actions and unzip.
22- 2 . Double-click ` start-tor.exe ` .
23- 3 . Tor bootstraps (direct by default). On 100% the system proxy is enabled
24- (HTTP 127.0.0.1:8118, SOCKS5 127.0.0.1:9050, DNS 127.0.0.1:53530).
25- Press Enter to stop Tor and restore the proxy.
23+ 2 . Double-click ` start-tor.exe ` , pick a mode:
24+ - ** 1 Direct** — no bridges (works when Tor is not blocked)
25+ - ** 2 WebTunnel** , ** 3 Obfs4** , ** 4 Vanilla** — bridges from ` data\bridges\ `
26+ Your choice is remembered for next time (` data\mode.txt ` ).
27+ 3 . On 100% bootstrap the system proxy is enabled (HTTP 127.0.0.1:8118,
28+ SOCKS5 127.0.0.1:9050, DNS 127.0.0.1:53530). Press Enter to stop and restore.
2629
27- ## If Tor is blocked
28-
29- Run ` data\scripts\fetch-bridges.ps1 ` to fetch fresh bridges (it rewrites
30- ` data\torrc ` ), then start again.
31-
32- ## Advanced
30+ You can also launch with a fixed mode or command:
3331
3432```
35- data\scripts\launcher.ps1 -NewCircuit request a new identity
36- data\scripts\launcher.ps1 -Stop stop Tor and restore the proxy
33+ start-tor.exe obfs4 start directly in obfs4 mode
34+ start-tor.exe --newcircuit request a new identity (NEWNYM)
35+ start-tor.exe --stop stop Tor and restore the proxy
3736```
3837
39- ## Build
38+ ## Building
4039
41- ` .github/workflows/build.yml ` builds tor + transports on every push and
42- publishes the ` tor-win64-portable ` artifact.
40+ ` .github/workflows/build.yml ` builds tor + transports and publishes the
41+ ` tor-win64-portable ` artifact on every push .
4342
4443- ` tor-src\ ` — unmodified official tor 0.4.9.11 source
45- - ` configs\torrc.iran ` — the portable config template (becomes ` data\torrc ` )
46- - ` scripts\start-tor.cs ` — source of ` start-tor.exe ` (compiled with ` build-start-tor.ps1 ` )
44+ - ` configs\torrc.iran ` — portable config template (becomes ` data\torrc.template ` )
45+ - ` bridges\ ` — tested bridge lists shipped with the release
46+ - ` scripts\start-tor.cs ` — source of ` start-tor.exe ` (compiled with ` scripts\build-start-tor.ps1 ` )
0 commit comments