A few things everyone can do now:

  1. Please consider running a relay to help the Tor network grow.
  2. Tell your friends! Get them to run relays. Get them to run hidden services. Get them to tell their friends.
  3. If you like Tor's goals, please take a moment to donate to support further Tor development. We're also looking for more sponsors — if you know any companies, NGOs, agencies, or other organizations that want anonymity / privacy / communications security, let them know about us.
  4. We're looking for more good examples of Tor users and Tor use cases. If you use Tor for a scenario or purpose not yet described on that page, and you're comfortable sharing it with us, we'd love to hear from you.


  1. Help translate the documentation into other languages. See the translation guidelines if you want to help out. We especially need Arabic or Farsi translations, for the many Tor users in censored areas.
  2. Evaluate and document our list of programs that can be configured to use Tor.
  3. We have a huge list of potentially useful programs that interface with Tor. Which ones are useful in which situations? Please help us test them out and document your results.


  1. Monitor some of our public mailing lists, like tor-talk, tor-relays, tor-dev, or tbb-dev, and summarize noteworthy exchanges into articles for Tor Weekly News.
  2. Create a presentation that can be used for various user group meetings around the world.
  3. Create a video about the positive uses of Tor, what Tor is, or how to use it. Some have already started on Tor's Media server, Howcast, and YouTube.
  4. Create a poster around a theme, such as "Tor for Freedom!"
  5. Create a t-shirt design that incorporates "Congratulations! You are using Tor!" in any language.
  6. Spread the word about Tor at a symposium or conference and use these Tor brochures in PDF and ODG format and translated to at least ten different languages as conversation starter.

Google Summer of Code

Tor is also taking part in this year's Google Summer of Code! To apply but you need to be either a present student or just graduated. See our page for Google Summer of Code for more information.


Below are a list of Tor related projects we're developing and/or maintaining. Most discussions happen on IRC so if you're interested in any of these (or you have a project idea of your own), then please join us in #tor-dev. Don't be shy to ask questions, and don't hesitate to ask even if the main contributors aren't active at that moment.

For a presentation summarizing many of these projects see...

Name Category Language Activity Contributors
Tor Core C Heavy nickm, athena, arma, dgoulet, asn, teor
Tor Browser Bundle Javascript, XUL, Scripting Heavy mikeperry, Pearl Crescent, GeKo
HTTPS Everywhere Browser Add-on Javascript Moderate pde, mikeperry
Nyx User Interface Python, Curses Moderate atagar
Orbot User Interface Java Moderate n8fr8
Tails OS image Sys Admin Heavy #tails
tor-ramdisk OS image Sys Admin Light blueness
Torsocks Usability C Light David Goulet
Tor Messenger Bundle JavaScript, XUL, Scripting Heavy arlolra, boklm, sukhe
TorBirdy Browser Add-on JavaScript Light sukhe
Flash Proxy Client Add-on Python, JavaScript, Go Light dcf, infinity0, Arlo Breault
Shadow Simulator C, Python Moderate robgjansen
Chutney Simulator Python Light teor
Stem Library Python Heavy atagar
Txtorcon Library Python, Twisted Moderate meejah
metrics-lib Library Java Moderate karsten, iwakeh
Metrics Client Service Java Heavy karsten, iwakeh
Atlas Client Service JavaScript Light irl
Compass Client Service Python None
Onionoo Backend Service Java Heavy karsten, iwakeh
ExitMap Backend Service Python None phw
DocTor Backend Service Python Light atagar
GetTor Client Service Python None ilv
TorCheck Client Service Go None Arlo
BridgeDB Backend Service Python Light isis
Ooni Probe Scanner Python Heavy hellais, aagbsn
TorPS Backend Service Python None Aaron Johnson
TorFlow Backend Service Python None aagbsn
Tor2web Client Service Python Heavy evilaliv3, hellais
CollecTor Backend Service Java Moderate karsten, iwakeh
ExoneraTor Client Service Java Light karsten, iwakeh
Anonbib Website Python None arma, nickm
* Project is still in an alpha state.

Tor (code, bug tracker)

Central project, providing the core software for using and participating in the Tor network. Numerous people contribute to the project to varying extents, but the chief architects are Nick Mathewson and Roger Dingledine.

Project Ideas:
Help improve Tor hidden services
Fuzzing coverage of Tor
Relay crypto parallelism
Anonymous local count statistics
Improved SOCKS5 variant
Hidden service crypto parallelism
Support all kinds of DNS in Tor
Improve IPv6 support

Tor Browser (code, bug tracker, design doc)

Tor Browser is an easy-to-use, portable package of Tor, HTTPS-Everywhere, NoScript, TorLauncher, Torbutton, and a Firefox fork, all preconfigured to work together out of the box. The modified copy of Firefox aims to resolve the privacy and security issues in mainline version.

Project Ideas:
Feedback Extension for Tor Browser
Crash Reporter for Tor Browser
Make Tor Browser Faster

HTTPS Everywhere (code, bug tracker)

HTTPS Everywhere is a Firefox and Chrome extension that encrypts your communications with many major websites, making your browsing more secure.

Nyx (code, bug tracker)

Nyx (previously arm) is a terminal status monitor for Tor intended for command-line aficionados, ssh connections, and anyone with a tty terminal. This works much like top does for system usage, providing real time statistics for bandwidth, resource usage, connections, and quite a bit more.

Orbot (code, bug tracker)

Provides Tor on the Android platform. The project is under active development, updates to latest Tor releases, and working to stay up to date with all changes in Android and mobile threats.

The Amnesic Incognito Live System (code, bug tracker, documentation, design, contribute)

The Amnesic Incognito Live System is a live CD/USB distribution preconfigured so that everything is safely routed through Tor and leaves no trace on the local system. This is a merger of the Amnesia and Incognito projects, and still under very active development.

Tor-ramdisk (code, documentation)

Tor-ramdisk is a uClibc-based micro Linux distribution whose sole purpose is to securely host a Tor server purely in RAM.

Torsocks (code, bug tracker)

Utility for adapting other applications to work with Tor. Development has slowed and compatibility issues remain with some platforms, but it's otherwise feature complete.

Tor Messenger (code, bug tracker)

Tor Messenger is a cross-platform chat program that aims to be secure by default and sends all of its traffic over Tor.

TorBirdy (code, bug tracker)

TorBirdy is Torbutton for Thunderbird and related Mozilla mail clients.

Flash Proxy (code, bug tracker)

Pluggable transport using proxies running in web browsers to defeat address-based blocking.

Shadow (code, bug tracker)

Shadow is a discrete-event network simulator that runs the real Tor software as a plug-in. Shadow is open-source software that enables accurate, efficient, controlled, and repeatable Tor experimentation. For another simulator, see ExperimenTor.

Chutney (code, bug tracker)

Integration test suite that spawns a local tor network, checking the interactions of its components.

Stem (code, bug tracker)

Python controller library for scripts and controller applications using Tor.

Project Ideas:
Stem Descriptors

Txtorcon (code, bug tracker)

Twisted-based asynchronous Tor control protocol implementation. Includes unit-tests, examples, state-tracking code and configuration abstraction. Used by OONI and APAF.

metrics-lib (code, bug tracker)

metrics-lib is a Java library that processes Tor network data provided by CollecTor or from other sources.

Metrics (web)

Processing and analytics of consensus data, provided to users via the metrics portal. This has been under active development for several years by Karsten Loesing.

Atlas (code)

Atlas is a web application to discover Tor relays and bridges. It provides useful information on how relays are configured along with graphics about their past usage.

This is the spiritual successor to TorStatus, the original codebase for which was written in PHP, and rewritten by students from Wesleyan as Django. If you dig into this space then also check out Globe, another similar site that's since been discontinued.

Compass (code, bug tracker)

Compass is a web and command line application that filters and aggregates the Tor relays based on various attributes.

Onionoo (code, bug tracker)

Onionoo is a JSON based protocol to learn information about currently running Tor relays and bridges.

ExitMap (code, bug tracker)

Scanner for the Tor network by Philipp Winter to detect malicious and misconfigured exits. For more information about how it works see his Spoiled Onions research paper.

DocTor (code, bug tracker)

DocTor is a notification service that monitors newly published descriptor information for issues. This is primarily a service to help the tor directory authority operators, but it also checks for a handful of other issues like sybil attacks.

Weather (code, bug tracker)

Provides automatic notification to subscribed relay operators when their relay's unreachable. This underwent a rewrite by the Wesleyan HFOSS team, which went live in early 2011.

GetTor (code, bug tracker)

E-mail autoresponder providing Tor's packages over SMTP. This has been relatively unchanged for quite a while.

TorCheck (code, bug tracker)

Site for determining if the visitor is using Tor or not.

BridgeDB (code, bug tracker)

Backend bridge distributor, handling the various pools they're distributed in. This was actively developed until Fall of 2010.

Ooni Probe (code, bug tracker)

Censorship scanner, checking your local connection for blocked or modified content.

TorPS (code)

The Tor Path Simulator (TorPS) is a tool for efficiently simulating path selection in Tor. It chooses circuits and assigns user streams to those circuits in the same way that Tor does. TorPS is fast enough to perform thousands of simulations over periods of months.

TorFlow (code, bug tracker)

Library and collection of services for actively monitoring the Tor network. These include the Bandwidth Scanners (measuring throughput of relays) and SoaT (scans for malicious or misconfigured exit nodes). SoaT was last actively developed in the Summer of 2010, and the Bandwidth Scanners a few months later. Both have been under active use since then, but development has stopped.

Tor2web (code)

Tor2web allows Internet users to browse websites running in Tor hidden services. It trades user anonymity for usability by allowing anonymous content to be distributed to non-anonymous users.

CollecTor (code, bug tracker)

CollecTor is the Tor network data archive that powers other services like Metrics and Onionoo.

ExoneraTor (code, bug tracker)

ExoneraTor is a service that answers the question whether there was a Tor relay running on a given IP address on a given date.

Anonymity Bibliography (code)

Anonbib is a list of important papers in the field of anonymity. It's also a set of scripts to generate the website from Latex (bibtex). If we're missing any important papers, please let us know!

Project Ideas

You may find some of these projects to be good ideas for Google Summer of Code. We have labelled each idea with which of our core developers would be good mentors. If one or more of these ideas looks promising to you, please contact us to discuss your plans rather than sending blind applications. You may also want to propose your own project idea — which often results in the best applications.

  1. Help improve Tor hidden services
    Language: C
    Likely Mentors: George (asn), David Goulet (dgoulet)

    The hidden services team is busy implementing proposal 224 but we are always open to mentoring fun and exciting hidden service projects.

    In the past, we've mentored a wide variety of projects related to hidden services, ranging from onion search engines, to scaling techniques for hidden services, and also various approaches of making onion services more usable by common people.

    Let us know if you have a project you would like to work on, or check our proposals and technical documents for various ideas.

  2. Fuzzing coverage of Tor
    Likely Mentors: Nick (nickm), ahf, teor

    Starting in 0.3.0.x, Tor supports a few fuzzing systems to check our code for bugs. But as of now, we only support a few possible entry points to Tor. It would be great to add fuzzing support for more of our codebase -- ideally to include our whole network-facing interface. That way, we could find more bugs in our code faster, and fix them before they can get out of hand.

    This won't be so easy, however: to fuzz effectively, we need to refactor or mock the target function so that it doesn't change any global state, or verify any signatures, or take too long to run. With lots of our network code, that's not so easy. Make sure you understand how our mocking system works, and what the challenges are, before you apply for this one.

  3. Relay crypto parallelism
    Likely Mentors: Isis, Nick (nickm)

    Tor relays spend a lot of time encrypting and decrypting relay traffic, doing SHA1 and AES-CTR operations. But right now, all of this is done in the main thread! It would be cool to split this across multiple cores instead.

    This won't be so easy though. The code today is written to expect immediate results from its encryption operations, so you would need to do some pretty tricky refactoring in order get performance and correctness here. Make sure you understand how circuit crypto is invoked today, and what the challenges are, before you apply for this one.

    For more information see its ticket.

  4. Anonymous local count statistics
    Likely Mentors: Nick (nickm), teor

    There are some places in Tor where we count things (like distinct IPs) to later report anonymized statistics. But if the local Tor instance were compromised, this data would be exposed. There are statistical methods which insteasd allow us to record this data in a way that's already anonymous, before we ever summarize it. Interested?

    For more information see its ticket.

  5. Improved SOCKS5 variant
    Likely Mentors: Nick (nickm), David Goulet (dgoulet)

    In proposal 229, we describe a bunch of additional SOCKS extensions that Tor-aware applications could use to get more fine-grained control over how Tor handles their streams. It would be cool to implement this! If there's time remaining, you might want to add support to one or more applications. Or maybe to torsocks?

    For more information see its ticket.

  6. Hidden service crypto parallelism
    Likely Mentors: Nick (nickm), David Goulet (dgoulet)

    Hidden services, hidden service clients, hidden service directories, and introduction points all need to do a few public-key operations as they operate. But right now, these operations are all done on the main thread. It would be good to have these run across multiple cores.

    This could probably be done in a way similar to how we currently hand circuit extension handshakes in onion.c and cpuworker.c, but we'd need to extend the state machine for hidden services to add an additional state. It could help hidden services operate much more efficiently.

    For more information see its ticket.

  7. Support all kinds of DNS in Tor
    Likely Mentors: Nick (nickm), George (asn)

    Right now Tor can query for the kind of DNS information you'd find in A records, AAAA records, and PTR records. It would be neat to be able to support more general DNS queries to allow things like MX loopups, DNSSEC lookups, and so on. We have a design proposal (number 219) for this, but it might need some clean-up.

    For more information see its ticket.

  8. Improve IPv6 support
    Likely Mentors: ahf, teor

    Tor works over IPv6, but require some manual configuration. Clients and relays could automatically detect IPv6 availability, and configure themselves appropriately. Implementing a "happy eyeballs"-like algorithm is a challenge in an anonymity network: are you up for it?

    For more information see its ticket.

  9. Feedback Extension for Tor Browser
    Likely Mentors: Nima (mrphs), Sukhbir (sukhe)

    Design and implement an extension for Tor Browser that can be used to gather end-user UI/UX feedback on an opt-in basis. While the design and implementation is left as an exercise for the applicant (and also serves as the qualification task), examples of the information we are looking to gather can include troubleshooting network connectivity issues, testing the various pluggable transports, or gathering information about the network of the users.

    Please propose the extension design in a way that the information is strictly on an opt-in basis and scrubs any information that can be used to identify a user, and also come up with a way to send the gathered information to a central server, whether to an onion address (if the user has Tor running), or otherwise. To start with, we are looking to gather only text as part of the feedback process.

  10. Crash Reporter for Tor Browser
    Likely Mentors: Tom Ritter (tjr), Georg (GeKo)

    Currently Tor Browser disables the Crash Reporter. We would like to build it reproducible, enable it, and configure it to report crashes containing non-detailed and impersonal information to Tor, on a .onion submission platform that would allow us to view and explore the crashes.

    The project will entail enabling the Crash Report on Tor Browser and creating a backend to receive reports from it. Once created, the crash reporter data will be analyzed and modified to fit Tor's requirements for personal data collection. As time permits, we will update the build system to ensure the crash reporter is built reproducibly and add data analysis tools for the crash report database to visualize top crashers and similar statistics.

  11. Make Tor Browser Faster
    Likely Mentors: Tom Ritter (tjr), Georg (GeKo)

    This project will enable and take advantage of HTTP/2, the Alt-Srv header, and tor's new single hop .onion mode to enable websites to transparently move their traffic to a .onion address. In addition to improvements in security, we will benchmark page load and paint times under normal HTTP/1.1, HTTP/2, and when taking advantage of features such as Server Push.

  12. Stem Descriptors
    Language: Python
    Likely Mentors: Damian Johnson (atagar), Philipp Winter (phw)

    Stem is a Python library for working with tor. With it you can build applications on tor as well as learn information about the relay network. This project concerns this second capability.

    Information about relays are published hourly in documents called descriptors. With Stem you can download, parse, and validate all kinds of descriptor documents.

    Ideas welcome! You're encouraged to brainstorm improvements we can make to this space but here's a few to get you started...

    • Validate signatures in the consensus. Stem has the ability to validate cryptographic signatures in several descriptor types but not the consensus.

    • Migrate from pycrypto to a supported library. Stem presently uses pycrypto for signature validation but it's no longer maintained. We should evaluate options and move to whatever whavever the cool kids are using nowadays.

    • Retrieve descriptors over tor's ORPort. Tor relays commonly provide two ports, an ORPort which is used by clients and a DirPort which is obsolete nowadays but in the past was used by tor to download descriptors. Stem still uses tor's DirPort to retrieve descriptors, but it would be neat if we could download from the ORPort instead.

      This requires implementing part of tor's communication protocol. Depending how complicated this is it might be neat to expand this task to allow the full construction of circuits, allowing client usage of tor without the C executable. Keep in mind though that this later bit hasn't been investigated and might be a pipe dream. ;P

    • Improve performance of reading descriptors. Stem isn't the only descriptor parsing library and sadly is the slowest. Tricks like lazy loading have substantially improved our performance but no doubt a dedicated effort to profile Stem would find more low hanging fruit.

    As part of applying for this project please get your hands wet with the codebase by contributing some patches for Stem!

  13. Ahmia - Hidden Service Search
    Language: Python, Django
    Likely Mentors: Juha Nurmi (numes), George (asn)

    Ahmia is open-source search engine software for Tor hidden service deep dark web sites. You can test the running search engine at ahmia.fi. For more information see our blog post about Ahmia's GSoC2014 development.

    Ahmia is a working search engine that indexes, searches, and catalogs content published on Tor Hidden Services. Furthermore, it is an environment to share meaningful insights, statistics, insights, and news about the Tor network itself. In this context, there is a lot of work to do.

    The Ahmia web service is written using the Django web framework. As a result, the server-side language is Python. On the client-side, most of the pages are plain HTML. There are some pages that require JavaScript, but the search itself works without client-side JavaScript.

    There are several possible directions for this project, including...

    1. Automate blacklisting (very important)
      • Fetch a list of child abuse media sites
      • Remove these sites from the search results
    2. Add hidden services funtion (very important)
      • You can add onions using HTML form
      • Call the crawler immidiately when a new site is added
    3. Elasticsearch
      • Must be updated to 5.X.X sooner or later
      • Adjust the settings
      • Automatically remove data older than, for instance, 90 days
    4. Maintainance
      • Update all software dependencies
      • Automate crash recovery for Tor, Elasticsearch and crawler
  14. Bring up new ideas!
    Don't like any of these? Look at the Tor development roadmap for more ideas, or just try out Tor and Tor Browser, and find out what you think needs fixing. Some of the current proposals might also be short on developers.

Tor Tip

Tor is written for and supported by people like you. Donate today!