[![Awesome](https://awesome.re/badge.svg)](https://awesome.re) # [![awesome-tor-logo](https://github.com/Polycarbohydrate/awesome-tor/assets/169401794/d8c7415e-1874-49f5-a1c6-04b3a8aa689f)](https://www.torproject.org) > Awesome Tor is a curated list of resources, tools, and applications related to the Tor network. > [!NOTE] > This product is produced independently from the Tor® anonymity software and carries no guarantee from The Tor Project about quality, suitability or anything else. Tor is a free overlay network for enabling anonymous communication. Built on free and open-source software and more than seven thousand volunteer-operated relays worldwide, users can have their Internet traffic routed via a random path through the network. Before you read, if you want to host a Snowflake bridge in your browser to help users in censored regions bypass censorship, [click here](https://polycarbohydrate.github.io/awesome-tor/selfhost-snowflake). Thank you. ## Contents - [Official Manual](#official-manual) - [Applications](#applications) - [Tails](#tails) - [Tor / Tor Browser](#tor--tor-browser) - [Other applications](#other-applications) - [Bridges](#bridges) - [Bypass Censorship](#bypass-censorship) - [Public reception, Impact, News, and Legislation](#public-reception-impact-news-and-legislation) - [State of the Onion](#state-of-the-onion) - [Whistleblowing](#whistleblowing) ## Official Manual - [About Tor Browser](https://tb-manual.torproject.org/about/) - Learn what Tor Browser can do to protect your privacy and anonymity. - [Anti-fingerprinting](https://tb-manual.torproject.org/anti-fingerprinting/) - How Tor Browser mitigates browser fingerprinting. - [Bridges](https://tb-manual.torproject.org/bridges/) - Most Pluggable Transports, such as obfs4, rely on the use of "bridge" relays. - [Circumvention](https://tb-manual.torproject.org/circumvention/) - What to do if the Tor network is blocked. - [Downloading](https://tb-manual.torproject.org/downloading/) - How to download Tor Browser. - [Installation](https://tb-manual.torproject.org/installation/) - Installing Tor Browser. - [Known Issues](https://tb-manual.torproject.org/known-issues/) - Issues with Tor. - [Make Tor Browser Portable](https://tb-manual.torproject.org/make-tor-portable/) - How to install Tor Browser onto removable media. - [Managing Identities](https://tb-manual.torproject.org/managing-identities/) - Learn how to control personally identifying information in Tor Browser. - [Mobile Tor](https://tb-manual.torproject.org/mobile-tor/) - Learn about Tor for mobile devices. - [Onion Services](https://tb-manual.torproject.org/onion-services/) - Services that are only accessible using Tor. - [Plugins, add-ons, and JavaScript](https://tb-manual.torproject.org/plugins/) - How Tor Browser handles add-ons, plugins, and JavaScript. - [Running Tor Browser](https://tb-manual.torproject.org/running-tor-browser/) - Learn how to use Tor Browser for the first time. - [Secure Connections](https://tb-manual.torproject.org/secure-connections/) - Learn how to protect your data using Tor Browser and HTTPS. - [Security Settings](https://tb-manual.torproject.org/security-settings/) - Configuring Tor Browser for security and usability. - [Support](https://tb-manual.torproject.org/support/) - How to get help, report a bug, or give feedback. - [Troubleshooting](https://tb-manual.torproject.org/troubleshooting/) - What to do if Tor Browser doesn't work properly. - [Updating](https://tb-manual.torproject.org/updating/) - How to update Tor Browser. - [Uninstalling](https://tb-manual.torproject.org/uninstalling/) - How to remove Tor Browser from your system. ## Applications ### Tails *A portable, Debian-based OS that runs from the RAM, leaving no trace. Uses Tor Browser as the primary browser.* - [Contribute](https://tails.net/contribute/index.en.html) - [Documentation](https://tails.net/doc/index.en.html) - [Download](https://tails.net/install/index.en.html) - [Homepage](https://tails.net/) - [How it works](https://tails.net/about/index.en.html) - [News](https://tails.net/news/index.en.html) - [Support](https://tails.net/support/index.en.html) ### Tor / Tor Browser *Open-source web browser that enables anonymous communication by directing internet traffic through a free, worldwide, volunteer, overlay network to conceal location and usage from anyone conducting network surveillance or traffic analysis.* - [About](https://www.torproject.org/about/history/) - [Commmunity](https://community.torproject.org/) - [Donate](https://donate.torproject.org/) - [Download](https://www.torproject.org/download/) - [Support](https://support.torproject.org/) - [News](https://blog.torproject.org/) - Core Tor / Little-t-tor - [Installation / Verify source code](https://support.torproject.org/little-t-tor/) - [Forum / Support](https://forum.torproject.org/c/support/core-tor/18) ### Other applications - [ansible-relayor](https://github.com/nusenu/ansible-relayor) - This is an ansible role for tor relay operators. - [bine](https://github.com/cretz/bine) - Go library for accessing and embedding Tor clients and servers. - [Briar](https://briarproject.org/) - Peer-to-peer messaging that bypasses centralized servers. Connect via Bluetooth, Wi-Fi, or Tor. - [Bulk Tor Exit Exporter](https://check.torproject.org/api/bulk) - Identify Tor exit nodes by showing exit node IPv4 and fingerprint information. - [Chutney](https://gitlab.torproject.org/tpo/core/chutney/) - Configures a Tor network, launches and monitors it, and then runs tests on it. - [dnscrypt-proxy](https://github.com/DNSCrypt/dnscrypt-proxy) - A flexible DNS proxy, with support for encrypted DNS protocols. - [dos-over-tor](https://github.com/skizap/dos-over-tor) - Proof of concept denial of service over Tor stress test tool. - [DocTor](https://gitlab.torproject.org/tpo/network-health/doctor/) - A notification service that monitors newly published descriptor information for issues. - [eotk](https://github.com/alecmuffett/eotk) - Tool for deploying HTTP/Onion sites to provide official, onion-networking for popular websites. - [exitmap](https://www.cs.kau.se/philwint/spoiled_onions/) - Scanner for Tor to detect bad exits (spoiled onions). - [haskell-tor](https://github.com/GaloisInc/haskell-tor) - A Haskell implementation of the Tor protocol. - [HTTPS Everywhere](https://www.eff.org/https-everywhere) - Only allows the browser to connect using HTTPS, built-in Tor. - [kalitorify](https://github.com/brainfucksec/kalitorify) - Shell script to create a transparent proxy through Tor for Kali Linux OS. - [Tor Metrics](https://metrics.torproject.org/) - Adjustable graphs to visualize the statistics of Tor. - [multitor](https://github.com/trimstray/multitor) - Create multiple Tor instances with load balancing. - [mini-tor](https://github.com/wbenny/mini-tor) - Smallest application size while accessing internet content and hidden service content. - [node-Tor](https://github.com/Ayms/node-Tor) - JavaScript open-source implementation of the Tor protocol on the server side and browsers. - [nyx](https://nyx.torproject.org/) - CLI interface which includes detailed real-time information about your relay. - [offensive-tor-toolkit](https://github.com/atorrescogollo/offensive-tor-toolkit) - Bind/Reverse Shells, SOCKS, etc over Tor in Go. - [onion-grater](https://github.com/Whonix/onion-grater) - Whitelisting filter for dangerous Tor control protocol commands. - [Onionbalance](https://onionbalance.readthedocs.io/en/latest/) - A way to load balance onion services across multiple backend Tor instances. - [Onionoo](https://metrics.torproject.org/onionoo.html) - A web-based protocol to learn about currently running Tor relays and bridges. - [OnionScan](https://onionscan.org/) - Help operators of hidden services find and fix operational security issues with their services. - [OnionShare](https://onionshare.org/) - Anonymously share files, host website, and chat using the Tor network. - [OONI](https://ooni.org/) - Test the blocking of websites and apps. Measure the speed and performance of your network. - [Orbot](https://guardianproject.info/apps/org.torproject.android/) - Tor on Android. - [Orfox](https://guardianproject.info/apps/info.guardianproject.orfox/) - Modified Tor browser for Android. Requires Orbot. - [php-torcontrol](https://github.com/dunglas/php-torcontrol) - TorControl is a PHP library to control a Tor server. - [Relay Search](https://metrics.torproject.org/rs.html) - Easy way to search for information about relays. - [Ricochet Refresh](https://www.ricochetrefresh.net/) - Ricochet Refresh is a peer-to-peer messenger app that uses Tor to connect clients. - [rotating-proxy](https://github.com/mattes/rotating-proxy) - Rotating Tor proxy with Docker. - [sbws](https://gitlab.torproject.org/tpo/network-health/sbws) - A Tor bandwidth scanner that generates bandwidth files to be used by Directory Authorities. - [Stormy](https://github.com/glamrock/stormy) - Stormy is a wizard that helps people create Tor Onion Services with just a few clicks. - [setup-tor](https://github.com/tor-actions/setup-tor) - Set up your GitHub Actions workflow with a specific version of Tor. - [Stem](https://stem.torproject.org/) - Stem is a Python controller library for Tor. - [Shadow](https://shadow.github.io/) - Shadow is a discrete-event network simulator that runs the real Tor software as a plug-in. - [Tallow](https://github.com/basil00/TorWall) - A program that redirects all outbound traffic from a Windows machine via the Tor anonymity network. - [tor_box](https://github.com/CMoncur/tor_box) - An all-inclusive Tor configuration for Raspberry Pi, that serves as a relay and personal Tor network. - [Tor_Onion_Proxy](https://github.com/thaliproject/Tor_Onion_Proxy_Library) - Provides a .JAR and an .AAR file for embedding Tor into a Java or Android Program. - [tor_ssh.sh](https://gitlab.com/grownetics/devops/blob/master/tor_ssh.sh) - Command that allows SSH access using Tor to any server. - [tor-browser-selenium](https://github.com/webfp/tor-browser-selenium) - A Python library to automate Tor Browser with Selenium WebDriver. - [tor-controller](https://github.com/kragniz/tor-controller) - Run Tor Onion Services on Kubernetes. - [tor-hidden-service](https://hub.docker.com/r/goldy/tor-hidden-service) - Docker container made for Onion Services in v2 or v3. - [tor-relay-bootstrap](https://github.com/coldhakca/tor-relay-bootstrap) - Script to bootstrap a Debian server to be a set-and-forget Tor relay. - [Tor.framework](https://github.com/iCepa/Tor.framework) - Tor.framework is the easiest way to embed Tor in your iOS application. - [tor.rb](https://github.com/dryruby/tor.rb) - This is a Ruby library for interacting with the Tor anonymity network. - [Tor2web](https://github.com/tor2web/Tor2web) - HTTP proxy software that enables access to Tor Hidden Services through common web browsers. - [TorBot](https://github.com/DedSecInside/TorBot) - Onion site crawler for data collection. - [TorChat-Mac](https://github.com/javerous/TorChat-Mac) - macOS native TorChat client. - [TorChat](https://github.com/prof7bit/TorChat) - Decentralized anonymous instant messenger on top of Tor Hidden Services. - [TorCheck](https://check.torproject.org/) - Determines if a visitor is using Tor or not. - [torDDoS](https://github.com/r3nt0n/torDDoS) - TorDDos is a Python tool to automatize DDoS attacks on a website from the Tor network. - [toriptabkes2](https://github.com/ruped24/toriptables2) - An anonymizer that sets up iptables and Tor to route all traffic through the Tor network. - [torps](https://github.com/torps/torps) - The Tor Path Simulator (TorPS) is a tool for efficiently simulating path selection in Tor. - [Torsocks](https://gitlab.torproject.org/tpo/core/torsocks/) - Allows you to use most applications safely with Tor. - [Tortilla](https://www.crowdstrike.com/resources/community-tools/tortilla-tool/) - Tool that securely, anonymously, and transparently routes all TCP/IP and DNS traffic through Tor. - [tun2tor](https://github.com/iCepa/tun2tor) - Rust library that creates a utun (userspace tunnel) interface, and connects it to a stream-based proxy. - [txtorcon](https://txtorcon.readthedocs.io/en/latest/) - An implementation of the control-spec for Tor using the Twisted networking library for Python. - [Vanguards](https://github.com/mikeperry-tor/vanguards) - This addon protects against guard discovery and related traffic analysis attacks. - [Whonix](https://www.whonix.org/) - OS designed for advanced security and privacy using the desktop-wide use of the Tor network. - [ZeroNet](https://zeronet.io/) - Free and uncensorable websites, using Bitcoin cryptography, the BitTorrent network, and Tor support. ## Bridges - [BridgeDB](https://pythonhosted.org/bridgedb/) - BridgeDB is a collection of backend servers used to distribute Tor Bridges. - [Conjure](https://gitlab.torproject.org/tpo/anti-censorship/pluggable-transports/conjure) - Conjure is an anti-censorship tool in the refraction networking (a.k.a. decoy routing) lineage of circumvention systems. - [Flash Proxies](https://crypto.stanford.edu/flashproxy/) - Outdated and deprecated bridge type. It is a miniature proxy that runs in a web browser. - [fteproxy](https://fteproxy.org/) - Outdated and deprecated bridge type. Tor traffic resembles plain HTTP. The name stands for "Format-Transforming Encryption." - [meek](https://support.torproject.org/glossary/meek/) - These pluggable transports make it look like you are browsing a major website instead of using Tor. - [obsf2](https://gitlab.torproject.org/tpo/anti-censorship/pluggable-transports/trac/-/issues/10314) - Outdated and deprecated bridge type. Predecessor of obsf3. - [obsf3](https://support.torproject.org/glossary/obfs3/) - Outdated and deprecated bridge type. Predecessor of obsf4. - [obsf4](https://support.torproject.org/glossary/obfs4/) - A pluggable transport that makes Tor traffic look random and also prevents censors from finding bridges by Internet scanning. - [ScrambleSuit](https://github.com/NullHypothesis/scramblesuit) - Outdated and deprecated bridge type. A pluggable transport protocol for obfsproxy. It is written in pure Python. - [Snowflake](https://snowflake.torproject.org/) - Making your internet activity appear as though you're using the internet for a regular video or voice call. - [Webtunnel](https://blog.torproject.org/introducing-webtunnel-evading-censorship-by-hiding-in-plain-sight/) - WebTunnel is a censorship-resistant pluggable transport designed to mimic encrypted web traffic (HTTPS) inspired by HTTPT. ## Bypass Censorship - [Firefly](https://github.com/yinghuocho/firefly-proxy) - A proxy software to help circumvent the Great Firewall. - [FWlite](https://github.com/v3aqb/fwlite) - An anti-censorship HTTP proxy with built-in shadowsocks support. - [Google Fi Wireless](https://fi.google.com/) - Great phone solution that allows calls, text messaging, and use of cellular data that bypasses China's Great Firewall. - [Lantern](https://github.com/getlantern/lantern) - Censorship circumvention tool available for free download on any operating system. - [MTProxy](https://github.com/TelegramMessenger/MTProxy) - Allows users in censored areas to connect to Telegram. - [NaïveProxy](https://github.com/klzgrad/naiveproxy) - NaïveProxy uses Chromium's network stack to camouflage traffic with strong censorship resistance and low detectability. - [nodeunblocker](https://github.com/nfriedly/nodeunblocker.com) - Host your copy of nodeunblocker.com using Node.js to bypass censorship on the internet. - [PrivadoVPN](https://privadovpn.com/) - VPN that is based in Switzerland and follows Swiss privacy laws. Bypasses even in China. - [ProtonVPN](https://protonvpn.com/) - VPN that allows for circumvention of censorship even in China. Free plan bypasses along with multiple servers and protocols. No logs policy. - [Private Bridges](https://bridges.torproject.org/) - Go to `I need an alternative way of getting bridges!` section. Follow the instructions. - [Runet Censorship Bypass](https://github.com/anticensority/runet-censorship-bypass) - A browser extension for Chromium and Firefox that helps to bypass censorship in Russia. - [StegoTorus](https://github.com/SRI-CSL/stegotorus) - A Camouflage Proxy for the Tor Anonymity System. - [trojan](https://github.com/trojan-gfw/trojan) - An unidentifiable mechanism that helps you bypass GFW. ## Public reception, Impact, News, and Legislation - [A close look at the Great Firewall of China](https://blog.torproject.org/closer-look-great-firewall-china/) - Some information about the censorship of Tor within China. - [Analyzing China's Blocking of Unpublished Tor Bridges](https://www.usenix.org/conference/foci18/presentation/dunna) - Study on how China blocks unlisted Tor bridges and how to prevent this. - [Anarcho-Tech NYC Wiki](https://github.com/AnarchoTechNYC/meta/wiki) - Wiki that explains how to stay private and anonymous online. - [Anonymity Bibliography](https://www.freehaven.net/anonbib/) - Selected papers in anonymity from 1977 - 2020. - [Dropping Docs on Darknet](https://www.youtube.com/watch?v=eQ2OZKitRwc) - DEF CON 22 - Adrian Crenshaw- Dropping Docs on Darknets: How People Got Caught. - [How governments have tried to block Tor](https://www.youtube.com/watch?v=DX46Qv_b7F4) - How governments have tried to block Tor by 28c3. - [How the Great Firewall of China is blocked in China](https://www.usenix.org/system/files/conference/foci12/foci12-final2.pdf) - Paper explaining how Tor is banned in China along with ways to circumvent it. - [Learning more about the GFW's active probing system](https://blog.torproject.org/learning-more-about-gfws-active-probing-system/) - Page about the GFW's censorship system and how it works. - [My Experience With the Great Firewall of China](http://blog.zorinaq.com/my-experience-with-the-great-firewall-of-china/) - Blog on CFW of China by an InfoSec professional during one of their visits. - [Protocol Misidentification Made Easy with Format-Transforming Encryption](https://kpdyer.com/publications/ccs2013-fte.pdf) - How FTE worked. - [Russia Passes Bill Banning Tor](https://www.themoscowtimes.com/2021/12/08/russia-blocks-tor-anonymity-service-a75760) - Article about Russia banning VPNs and Tor. - [Scaling Tor hidden services](https://www.benthamsgaze.org/2015/11/17/scaling-tor-hidden-services/) - How to scale hidden services. - [ScrambleSuit: A Polymorph Network Protocol to Circumvent Censorship](http://arxiv.org/pdf/1305.3199) - How ScrambleSuit worked. - [Snowden Revelations](https://www.theguardian.com/world/interactive/2013/nov/01/snowden-nsa-files-surveillance-revelations-decoded) - The Snowden Revelations explained. - [State of the Onion - 2023](https://blog.torproject.org/event/state-of-the-onion-2023/) - Tor Project's annual virtual event where we share updates from teams and the community, highlighting their work and the impact it has made across the globe during the year. - [StegoTorus: A Camouflage Proxy for the Tor Anonymity System](https://www.freehaven.net/anonbib/cache/ccs2012-stegotorus.pdf) - A paper on how StegoTorus works. - [Technical and Legal Overview of Tor](https://ccdcoe.org/uploads/2018/10/TOR_Anonymity_Network.pdf) - Overview of Tor is presented from the technical perspective and also several legal issues related to its use are analyzed. - [Tor after the Snowden revelations](https://blog.torproject.org/tor-in-2023/) - About the Snowden revelations and what Tor will do in 2024. - [Tor Browser Afforded CDA Immunity for Dark Web Transactions](https://www.govinfo.gov/content/pkg/USCOURTS-utd-2_18-cv-00712/pdf/USCOURTS-utd-2_18-cv-00712-0.pdf) - Court document about the death of a minor through purchasing narcotics on Tor. - [Tor Hidden Services and Deanonyminization](https://www.youtube.com/watch?v=HQXRURfrf8w) - Talk about how Tor and its services can be exploited to expose a user's information as well as how to prevent attacks. - [Tor Overview](https://www.privacyguides.org/en/advanced/tor-overview/) - Overview of Tor by Privacyguides. - [Understanding The Onion Router in 2024](https://www.privacyjournal.net/privacy/tor-network/) - Explains what Tor is; update for 2024. - [What is Tor?](https://www.amnesty.org/en/latest/campaigns/2024/02/what-is-tor-and-how-does-it-advance-human-rights/) - Gives a very good explanation for Tor, Onion Services, and how it promotes human rights. ## State of the Onion - [2024](https://blog.torproject.org/state-of-the-onion-2024/) - State of the Onion report for the year 2024. - [2023](https://blog.torproject.org/state-of-the-onion-2023/) - State of the Onion report for the year 2023. - [2022](https://blog.torproject.org/state-of-the-onion-2022/) - State of the Onion report for the year 2022. - [2021](https://blog.torproject.org/state-of-the-onion-2021/) - State of the Onion report for the year 2021. - [2020](https://blog.torproject.org/state-of-the-onion-2020/) - State of the Onion report for the year 2020. - [2019](https://www.youtube.com/watch?v=W0NR6M_08oM) - State of the Onion report for the year 2019. ## Whistleblowing - [GlobaLeaks](https://www.globaleaks.org/) - GlobaLeaks is free, open-source software enabling anyone to easily set up and maintain a secure whistleblowing platform. - [SecureDrop](https://github.com/freedomofpress/securedrop) - SecureDrop is an open-source whistleblower submission system that media organizations and NGOs can install to securely accept documents from anonymous sources. - [WikiLeaks](https://wikileaks.org/) - WikiLeaks specializes in the analysis and publication of large datasets of censored or otherwise restricted official materials involving war, spying, and corruption. [tor.md Github](https://github.com/polycarbohydrate/awesome-tor )