center2055/OnionHop v3.1.0

OnionHop v3.1.0

on GitHub

A feature + stability release rolling up everything since v3.0.0. Upgrading is recommended for everyone, especially anyone in a censored network or whose Windows username contains a space.

New

• Upstream proxy (Settings → Network → "Upstream proxy") — make Tor connect out through another SOCKS5 or HTTPS proxy first (host, port, optional username/password). Lets you run OnionHop behind a corporate/SOCKS gateway, a tool like Proxifier, or a Psiphon-style front instead of conflicting with it in the network stack.

Fixed

• Critical — bridges now work when your Windows folder has a space (e.g. C:\Users\First Last). The pluggable-transport path was being truncated at the space, so no bridge could launch and you couldn't connect in a censored network. (#51)
• Critical — "Local proxy only" mode no longer breaks your network. It was forcing all system DNS through Tor while traffic went direct, killing name resolution for every app.
• Smart Connect / automatic bridges no longer give up on a working transport too early — it keeps a transport as long as Tor is making real progress, instead of bailing on the dead bridges in a large set. Much more reliable in heavily filtered networks. (#44)
• Orphaned bridge helpers cleaned up — a leftover lyrebird/snowflake from a previous run no longer causes "terminated with status code 2" and dead bridges. (#48)
• Cached bridges are kept when the bridge sources are unreachable (censored networks) and survive reinstalls/restarts for up to a week, instead of being discarded. (#48)
• Snowflake AMP cache toggle added to Settings → Network → Bridges. (#45)
• Visible scrollbars on long lists (DNS-hop providers, Bridge Scanner, app picker).
• Bridge Scanner / log exports save as a proper .txt file.
• Split-tunnel app picker now lists running apps on Linux and macOS too.
• Linux TUN/VPN shows the exact env-preserving command to relaunch the AppImage with root. (#44)
• (carried from the v3.0.2 fix) startup crash (duplicate resource key) and the Windows installer that was missing the launcher are both fixed and guarded against in the build.

Note on antivirus

The unsigned Windows builds can be flagged by Windows Defender as a generic Trojan:Script/Wacatac.B!ml false positive (common for unsigned apps that bundle Tor). This release changes how the Windows build is compiled to reduce that, and the files are being submitted to Microsoft. OnionHop is fully open-source — if your AV removes a file, you can restore it from Protection History or use the portable build.

Downloads

Linux & macOS CLI are still coming soon.