tor-webwml.git

1) ## translation metadata
2) # Revision: $Revision: 25342 $
3) 

4) #include "head.wmi" TITLE="Tor Project: Onionoo" CHARSET="UTF-8"

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

9)     <a href="<page projects/torstatus>">Onionoo</a>

10)   </div>
11) 	<div id="maincol"> 
12) 

13)     <h1>Onionoo</h1>

14) 

15)     <p>Onionoo is a web-based protocol to learn about currently running
16)     Tor relays and bridges.  Onionoo itself was not designed as a service
17)     for human beings&mdash;at least not directly.  Onionoo provides the
18)     data for other applications and websites which in turn present Tor
19)     network status information to humans.  There are currently two
20)     Onionoo clients available:</p>

21)     <ul>
22)     <li><a href="https://atlas.torproject.org/">Atlas</a> is a web
23)     application to discover Tor relays and bridges. It provides useful
24)     information on how relays are configured along with graphics about
25)     their past.</li>
26)     <li><a href="https://code.google.com/p/moniono/">mOnionO</a> is an
27)     Android app that lets you add your relays or bridges to your favorites
28)     list and keeps you always informed whether they are running or
29)     not.</li>
30)     </ul>
31) 

32)     <h2>Developing Onionoo applications</h2>

33) 

34)     <p>The project pages of the Onionoo clients listed above have further
35)     information for contacting the authors and contributing ideas or code.
36)     The authors will be happy to hear your thoughts!</p>

37) 

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

42)     facilitates developing new applications displaying Tor status

43)     information.  Here are a few ideas for new Onionoo clients:</p>

44)     <ul>
45)     <li>Tor controller extension: Extend
46)     <a href="<page projects/vidalia>">Vidalia</a> and/or
47)     <a href="<page projects/arm>">arm</a> to look up details for the bridge
48)     that the user is running and display what pool the bridge is contained
49)     in.</li>
50)     <li>Social network site plugin: Add a plugin to the social network
51)     site of your choice to show your friends what Tor relays and bridges
52)     you're running and how that helps users around the world.</li>
53)     <li>Desktop tray icon: Write a tray icon for your favorite desktop
54)     environment that tells you when your relay or bridge is down and that
55)     displays some basic usage statistics.</li>
56)     <li>E-mail notification service: Improve our e-mail notification
57)     service <a href="https://weather.torproject.org/">Weather</a> by
58)     implementing its own relay search or extending it to report when a
59)     bridge drops off the network.</li>
60)     <li>Command-line tool: Implement a command-line tool that quickly
61)     searches a relay or bridge and prints out some status information to
62)     help debug problems.</li>
63)     <li>(Insert your idea here.)</li>
64)     </ul>
65) 
66)     <p>Want to help with developing the Onionoo server that provides

67)     Tor status data, or want to run your own Onionoo server instance?  The