docs/en/android.wml
2a9aaa80
 ## translation metadata
40e07e2e
 # Revision: $Revision$
2a9aaa80
 # Translation-Priority: 3-low
 
 #include "head.wmi" TITLE="Tor Project: Android Instructions" CHARSET="UTF-8"
 <div id="content" class="clearfix">
   <div id="breadcrumbs">
b289ef06
     <a href="<page index>">Home &raquo; </a>
2a9aaa80
     <a href="<page docs/documentation>">Documentation &raquo; </a>
     <a href="<page docs/android>">Android</a>
   </div>
   <div id="maincol">
     <h2><a class="anchor" href="#Android">Tor on Android</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
     Tor is available for Android by installing our package named Orbot.
     </p>
     <p>
     Orbot is an application that allows mobile phone users to access the web,
     instant messaging and email without being monitored or blocked by their mobile
     internet service provider. Orbot brings the features and functionality of Tor
     to the Android mobile operating system.
     </p>
     <p>
     Orbot contains Tor, libevent and privoxy. Orbot provides a local HTTP proxy
     and the standard SOCKS4A/SOCKS5 proxy interfaces into the Tor network. Orbot
     has the ability to transparently torify all of the TCP traffic on your Android
     device when it has the correct permissions.
     </p>
     
     <a id="QrCode"></a>
     <h2><a class="anchor" href="#QrCode">Installing Tor with a QR code</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
     Orbot is easy to install by simply scanning the following QR code with your
     Android Barcode scanner.
     </p>
     
     <p>
b15361eb
     <a href="$(IMGROOT)/android/orbot-qr-code-latest.png"><img alt="Android QR code" src="$(IMGROOT)/android/orbot-qr-code-latest.png"/></a>
2a9aaa80
     </p>
     
     <a id="Market"></a>
     <h2><a class="anchor" href="#Market">Installing Tor from the Android Market</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
     Orbot is not currently in the Android Market. It will be available in the
     market in the very near future.
     </p>
     
     <a id="Manual"></a>
     <h2><a class="anchor" href="#Manual">Installing Tor from our website manually</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
     You can download <a href="../<package-androidbundle-alpha>">our most recent version of Orbot</a> and <a href="../<package-androidbundle-alpha-sig>">the gpg signature</a> from our server.
     </p>
     
     <a id="Screenshots"></a>
     <h2><a class="anchor" href="#Screenshots">Screenshots of Tor on Android</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
fe2909c4
     <a href="$(IMGROOT)/android/android-off.jpg">
b15361eb
     <img alt="Android Tor off" src="$(IMGROOT)/android/android-off-150x150.jpg"/>
2a9aaa80
     </a>
fe2909c4
     <a href="$(IMGROOT)/android/android-bootstrapping.jpg">
b15361eb
     <img alt="Android Tor bootstrapping" src="$(IMGROOT)/android/android-bootstrapping-150x150.jpg"/>
2a9aaa80
     </a>
fe2909c4
     <a href="$(IMGROOT)/android/android-activated.jpg">
e7f4c8a4
     <img alt="Android Tor activated"
fe2909c4
     src="$(IMGROOT)/android/android-activated-150x150.jpg"/>
2a9aaa80
     </a>
fe2909c4
     <a href="$(IMGROOT)/android/android-settings.jpg">
e7f4c8a4
     <img alt="Android Tor settings"
fe2909c4
     src="$(IMGROOT)/android/android-settings-150x150.jpg"/>
2a9aaa80
     </a>
     </p>
     
     <a id="ProxySettings"></a>
     <h2><a class="anchor" href="#ProxySettings">Proxy settings and configuration
     </a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
dabf6382
       Orbot offers three interfaces into the Tor network:
     </p>
2a9aaa80
     <ul>
     <li>SOCKS 4A/5 proxy 127.0.0.1:9050</li>
     <li>HTTP proxy 127.0.0.1:8118 </li>
     <li>Transparent proxying (on select devices)</li>
     </ul>
     
     <a id="Notes"></a>
     <h2><a class="anchor" href="#Notes">Platform specific notes</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
     The current version of Orbot ships with the following components:
4f4d71d8
     <b><version-androidbundle-privoxy>, <version-androidbundle-libevent></b>
2a9aaa80
     </p>
ed5ac546
     <br>
2a9aaa80
     <p>
dabf6382
       For standard Android 1.x devices (G1, MyTouch3G, Hero, Droid Eris, Cliq, Moment):
     </p>
2a9aaa80
     <ul>
     <li>The “ProxySurf” browser available in the Android Market allows for use
         of a proxy. Simply set the HTTP Proxy to '127.0.0.1' and port '8118'.
         <b>This only proxies some traffic and should not be considered secure.</b>
         </li>
     <li>For Instant Messsaging, try “Beem” in the market, and set the Proxy to SOCKS5 '127.0.0.1' and port '9050'.</li>
     </ul>
     <p>
dabf6382
       For Android 2.x devices: Droid, Nexus One
     </p>
2a9aaa80
     <ul>
     <li>You must root your device for Orbot to transparently proxy all TCP traffic.</li>
     <li>For non-modified and non-rooted phones, you'll want to manually configure
         your specific applications.</li>
     <li>If you root your device, whether it is 1.x or 2.x based, Orbot will
         automatically, transparently proxy all web traffic on port 80 and 443
         and all DNS requests. This includes the built-in Browser, Gmail, YouTube,
         Maps and any other application that uses standard web traffic.</li>
     </ul>
     
     <a id="Source"></a>
     <h2><a class="anchor" href="#Source">Source code access</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
     All of the source code is available in the
     <a href="https://svn.torproject.org/svn/projects/android/trunk/Orbot/">Orbot
     subversion repository</a>.
     </p>
     
     <p>
     Note that this might not always give you the latest stable Tor version.
     Additionally, the Android web browser does not have Torbutton. This means that
     while it may be useful for circumvention, it probably is unsuitable for strong
     web browser anonymity requirements.
     </p>
     
ed5ac546
     <hr>
2a9aaa80
     
     <p>If you have suggestions for improving this document, please <a
     href="<page about/contact>">send them to us</a>. Thanks!</p>
   </div>
   <!-- END MAINCOL -->
   <div id = "sidecol">
 #include "side.wmi"
 #include "info.wmi"
   </div>
   <!-- END SIDECOL -->
 </div>
 <!-- END CONTENT -->
 #include <foot.wmi>