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>
d44a2886
     Orbot contains Tor and libevent. Orbot provides a local HTTP proxy
2a9aaa80
     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
172e44ac
     device when it has the correct permissions and system libraries.
2a9aaa80
     </p>
d44a2886
 
     <a id="F-Droid"></a>
1091bf99
     <h2><a class="anchor" href="#fdroid">Installing Orbot from a F-Droid repository</a></h2>
ed5ac546
     <br>
d44a2886
     <p>Follow <a href="https://guardianproject.info/2012/03/15/our-new-f-droid-app-repository/">these instructions</a> to install from Guardian Project's repository.</p>
 
2a9aaa80
     <a id="Market"></a>
d44a2886
     <h2><a class="anchor" href="#Market">Installing Orbot from the Android Market</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
5a99dfe1
     Orbot is available <a href="https://play.google.com/store/apps/details?id=org.torproject.android">in the Android Market</a>.
2a9aaa80
     </p>
d44a2886
 
2a9aaa80
     <a id="Manual"></a>
d44a2886
     <h2><a class="anchor" href="#Manual">Installing Tor from Guardian's website manually</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
d44a2886
     You can download the most recent version from the <a href="https://guardianproject.info/releases/">Guardian Project release</a> listing.
2a9aaa80
     </p>
d44a2886
 
2a9aaa80
     <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>
d44a2886
 
2a9aaa80
     <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>
d44a2886
 
2a9aaa80
     <a id="Notes"></a>
     <h2><a class="anchor" href="#Notes">Platform specific notes</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
172e44ac
       For standard Android 1.x devices:
dabf6382
     </p>
2a9aaa80
     <ul>
172e44ac
     <li>The Orweb browser available in the Android Market integrates directly with Orbot, and offers a number of other privacy-oriented features.
2a9aaa80
         </li>
172e44ac
     <li>For Instant Messsaging, try <a href="https://guardianproject.info/apps/gibber">Gibberbot</a>, which includes support for connecting via Tor and Off-the-Record encryption.</li>
2a9aaa80
     </ul>
     <p>
172e44ac
       For Android 2.x devices:
dabf6382
     </p>
2a9aaa80
     <ul>
172e44ac
     <li>You must root your device and update the firmware to an iptables-capable ROM for Orbot to transparently proxy all TCP traffic.</li>
     <li>For non-modified and non-rooted phones, you'll want to manually configure HTTP or SOCKS proxy settings for specific applications.</li>
37fd567b
     <li>If you root your device and install an iptables-capable ROM (such as <a href="http://www.cyanogenmod.com/">Cyanogen</a>), Orbot can transparently proxy traffic on an app-by-app basis through Tor.</li>
a8e1f944
     <li>You can also install Firefox for Android from the market with the <a href="https://guardianproject.info/apps/proxymob">Proxy Mobile Add-on</a> or install the text-only “NDBrowser” from the Android Market.
d44a2886
 Both of these solutions all routing of web access through Tor on standard, un-rooted devices.</li>
172e44ac
     <li>For Instant Messaging, try <a href="https://guardianproject.info/apps/gibber">Gibberbot</a>, which includes support for connecting via Tor and Off-the-Record encryption.</li>
2a9aaa80
     </ul>
d44a2886
 
2a9aaa80
     <a id="Source"></a>
     <h2><a class="anchor" href="#Source">Source code access</a></h2>
ed5ac546
     <br>
2a9aaa80
     <p>
202900fc
     All of the source code is available in the <a
     href="https://gitweb.torproject.org/orbot.git">Orbot git
     repository.</a>.
2a9aaa80
     </p>
d44a2886
 
2a9aaa80
     <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>
d44a2886
 
ed5ac546
     <hr>
d44a2886
 
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 -->
d44a2886
 #include <foot.wmi>