Onionoo — a Tor network status protocol


a Tor network status protocol

Onionoo is a web-based protocol to learn about currently running Tor relays and bridges. Onionoo itself was not designed as a service for human beings—at least not directly. Onionoo provides the data for other applications and websites which in turn present Tor network status information to humans. The following Onionoo clients are currently available:

The following library facilitates development of Onionoo clients:

Developing Onionoo applications

The project pages of the Onionoo clients listed above have further information for contacting the authors and contributing ideas or code. The authors will be happy to hear your thoughts!

You don't find your favorite Onionoo client above? Want to implement your own and tell us to add it to the list? The Onionoo clients above are backed by a web-basedprotocol, which facilitates developing new applications displaying Tor status information. Here are a few ideas for new Onionoo clients:

Want to help with developing the Onionoo server that provides Tor status data, or want to run your own Onionoo server instance? The Onionoo server is written in Java with a tiny portion of Java Servlets. Instructions for setting up the Onionoo server to fetch the required data from the Tor servers is described in the INSTALL file in the sources. For more details see the and .

Related projects

TorStatus is the name of a nowadays website that displays Tor relay information similar to . There are still a few .

There's another project from summer 2011 called TorStatus which is a of the original TorStatus in Python/Django. Unfortunately, it's also unmaintained.

Finally, there's the which has the primary purpose of indicating problems with creating a network status consensus. As a side-effect this page lists all currently running relays and how the directory authorities voted on them.