tor-webwml.git

projects/en/torstatus.wml   1) ## translation metadata
projects/en/torstatus.wml   2) # Revision: $Revision: 25342 $
projects/en/torstatus.wml   3) 

projects/en/torstatus.wml   4) #include "head.wmi" TITLE="Tor Project: Onionoo" CHARSET="UTF-8"

projects/en/torstatus.wml   5) <div id="content" class="clearfix">
projects/en/torstatus.wml   6) 	<div id="breadcrumbs">
projects/en/torstatus.wml   7)     <a href="<page index>">Home &raquo; </a>
projects/en/torstatus.wml   8)     <a href="<page projects/projects>">Projects &raquo; </a>

projects/en/onionoo.wml     9)     <a href="<page projects/onionoo>">Onionoo</a>

projects/en/torstatus.wml  10)   </div>
projects/en/torstatus.wml  11) 	<div id="maincol"> 
projects/en/torstatus.wml  12) 

projects/en/torstatus.wml  13)     <h1>Onionoo</h1>

projects/en/torstatus.wml  14) 

projects/en/torstatus.wml  15)     <p>Onionoo is a web-based protocol to learn about currently running
projects/en/torstatus.wml  16)     Tor relays and bridges.  Onionoo itself was not designed as a service
projects/en/torstatus.wml  17)     for human beings&mdash;at least not directly.  Onionoo provides the
projects/en/torstatus.wml  18)     data for other applications and websites which in turn present Tor

projects/en/onionoo.wml    19)     network status information to humans.  The following Onionoo clients
projects/en/onionoo.wml    20)     are currently available:</p>

projects/en/torstatus.wml  21)     <ul>
projects/en/torstatus.wml  22)     <li><a href="https://atlas.torproject.org/">Atlas</a> is a web

projects/en/onionoo.wml    23)     application to discover Tor relays. It provides useful

projects/en/torstatus.wml  24)     information on how relays are configured along with graphics about
projects/en/torstatus.wml  25)     their past.</li>

projects/en/onionoo.wml    26)     <li><a href="https://compass.torproject.org/">Compass</a>
projects/en/onionoo.wml    27)     is a Python script and website that extracts consensus weight
projects/en/onionoo.wml    28)     information of currently running relays and aggregates weights of
projects/en/onionoo.wml    29)     relays running in the same country or same autonomous system.</li>

projects/en/onionoo.wml    30)     <li><a href="http://tor2web.org/">Tor2web</a> is a web proxy to Tor
projects/en/onionoo.wml    31)     Hidden Services. It uses Onionoo to get the list of currently running
projects/en/onionoo.wml    32)     Tor Exits to detect if the client is a Tor user and if so redirect
projects/en/onionoo.wml    33)     them to the .onion address.</li>

projects/en/onionoo.wml    34)     <li><a href="https://globe.torproject.org/">Globe</a> is a web
projects/en/onionoo.wml    35)     application

projects/en/onionoo.wml    36)     that allows you to search for Tor relays and bridges. It gives you a
projects/en/onionoo.wml    37)     detailed overview of properties and configurations of a relay or
projects/en/onionoo.wml    38)     bridge.</li>

projects/en/onionoo.wml    39)     <li>The <a href="https://nos-oignons.net/Services/index.en.html">Nos
projects/en/onionoo.wml    40)     oignons</a> website uses Onionoo to visualize bandwidth histories of
projects/en/onionoo.wml    41)     their relays.</li>
projects/en/onionoo.wml    42)     <li>The <a href="https://metrics.torproject.org/bubbles.html">metrics
projects/en/onionoo.wml    43)     website</a> visualizes diversity of the Tor network using bubble
projects/en/onionoo.wml    44)     graphs.</li>

projects/en/torstatus.wml  45)     </ul>
projects/en/torstatus.wml  46) 

projects/en/onionoo.wml    47)     The following Onionoo clients are currently unmaintained, but are
projects/en/onionoo.wml    48)     still a good idea:
projects/en/onionoo.wml    49)     <ul>
projects/en/onionoo.wml    50)     <li><a href="https://code.google.com/p/moniono/">mOnionO</a> is an
projects/en/onionoo.wml    51)     Android app that lets you add your relays or bridges to your favorites
projects/en/onionoo.wml    52)     list and keeps you always informed whether they are running or
projects/en/onionoo.wml    53)     not.</li>
projects/en/onionoo.wml    54)     </ul>
projects/en/onionoo.wml    55) 

projects/en/torstatus.wml  56)     <h2>Developing Onionoo applications</h2>

projects/en/torstatus.wml  57) 

projects/en/torstatus.wml  58)     <p>The project pages of the Onionoo clients listed above have further
projects/en/torstatus.wml  59)     information for contacting the authors and contributing ideas or code.
projects/en/torstatus.wml  60)     The authors will be happy to hear your thoughts!</p>

projects/en/torstatus.wml  61) 

projects/en/torstatus.wml  62)     <p>You don't find your favorite Onionoo client above?  Want to
projects/en/torstatus.wml  63)     implement your own and tell us to add it to the list?  The Onionoo
projects/en/torstatus.wml  64)     clients above are backed by a web-based
projects/en/torstatus.wml  65)     <a href="http://onionoo.torproject.org/">protocol</a>, which

projects/en/torstatus.wml  66)     facilitates developing new applications displaying Tor status

projects/en/torstatus.wml  67)     information.  Here are a few ideas for new Onionoo clients:</p>

projects/en/torstatus.wml  68)     <ul>
projects/en/torstatus.wml  69)     <li>Tor controller extension: Extend
projects/en/torstatus.wml  70)     <a href="<page projects/vidalia>">Vidalia</a> and/or
projects/en/torstatus.wml  71)     <a href="<page projects/arm>">arm</a> to look up details for the bridge
projects/en/torstatus.wml  72)     that the user is running and display what pool the bridge is contained
projects/en/torstatus.wml  73)     in.</li>
projects/en/torstatus.wml  74)     <li>Social network site plugin: Add a plugin to the social network
projects/en/torstatus.wml  75)     site of your choice to show your friends what Tor relays and bridges
projects/en/torstatus.wml  76)     you're running and how that helps users around the world.</li>
projects/en/torstatus.wml  77)     <li>Desktop tray icon: Write a tray icon for your favorite desktop
projects/en/torstatus.wml  78)     environment that tells you when your relay or bridge is down and that
projects/en/torstatus.wml  79)     displays some basic usage statistics.</li>
projects/en/torstatus.wml  80)     <li>E-mail notification service: Improve our e-mail notification
projects/en/torstatus.wml  81)     service <a href="https://weather.torproject.org/">Weather</a> by
projects/en/torstatus.wml  82)     implementing its own relay search or extending it to report when a
projects/en/torstatus.wml  83)     bridge drops off the network.</li>
projects/en/torstatus.wml  84)     <li>Command-line tool: Implement a command-line tool that quickly
projects/en/torstatus.wml  85)     searches a relay or bridge and prints out some status information to
projects/en/torstatus.wml  86)     help debug problems.</li>
projects/en/torstatus.wml  87)     <li>(Insert your idea here.)</li>
projects/en/torstatus.wml  88)     </ul>
projects/en/torstatus.wml  89) 
projects/en/torstatus.wml  90)     <p>Want to help with developing the Onionoo server that provides

projects/en/torstatus.wml  91)     Tor status data, or want to run your own Onionoo server instance?  The