webwml/docs/en/android.wml

## translation metadata
# Revision: $Revision: 22402 $
# Translation-Priority: 3-low

#include "head.wmi" TITLE="Tor Project: Android Instructions" CHARSET="UTF-8"
<div id="content" class="clearfix">
  <div id="breadcrumbs">
    <a href="<page index>">Home &raquo; </a>
    <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>
    <br />
    <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>
    <br />
    <p>
    Orbot is easy to install by simply scanning the following QR code with your
    Android Barcode scanner.
    </p>
    
    <p>
    <a href="../img/android/orbot-qr-code-latest.png">
    <img border="0" alt="Android QR code"
    src="../img/android/orbot-qr-code-latest.png"/>
    </a>
    </p>
    
    <a id="Market"></a>
    <h2><a class="anchor" href="#Market">Installing Tor from the Android Market</a></h2>
    <br />
    <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>
    <br />
    <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>
    <br />
    <p>
    <a href="../img/android/android-off.jpg">
    <img border="0" alt="Android Tor off"
    src="../img/android/android-off-150x150.jpg"/>
    </a>
    <a href="../img/android/android-bootstrapping.jpg">
    <img border="0" alt="Android Tor bootstrapping"
    src="../img/android/android-bootstrapping-150x150.jpg"/>
    </a>
    <a href="../img/android/android-activated.jpg">
    <img border="0" alt="Android Tor activated"
    src="../img/android/android-activated-150x150.jpg"/>
    </a>
    <a href="../img/android/android-settings.jpg">
    <img border="0" alt="Android Tor settings"
    src="../img/android/android-settings-150x150.jpg"/>
    </a>
    </p>
    
    <a id="ProxySettings"></a>
    <h2><a class="anchor" href="#ProxySettings">Proxy settings and configuration
    </a></h2>
    <br />
    <p>
    Orbot offers three interfaces into the Tor network:
    <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>
    </p>
    
    <a id="Notes"></a>
    <h2><a class="anchor" href="#Notes">Platform specific notes</a></h2>
    <br />
    <p>
    The current version of Orbot ships with the following components:
    <b><version-android-components></b>
    </p>
    <br />
    <p>
    For standard Android 1.x devices (G1, MyTouch3G, Hero, Droid Eris, Cliq, Moment):
    <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>
    <p>
    For Android 2.x devices: Droid, Nexus One
    <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>
    </p>
    
    <a id="Source"></a>
    <h2><a class="anchor" href="#Source">Source code access</a></h2>
    <br />
    <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>
    
    <hr />
    
    <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>