h1. Tools installation

This page explains how to install the various tools used with Replicant. It is assumed that you are running a GNU/Linux operating system.

h2. ADB

ADB can be installed from the repositories of your GNU/Linux distribution (if available) or from our released tools.
Note: you may need to run ADB as root if your current user doesn't have USB access privileges.

h3. From GNU/Linux distributions repositories

h4. Debian

<pre>
apt-get install android-tools-adb
</pre>

h4. Parabola
<pre>
pacman -S android-tools
</pre>

h3. From our released tools

1. Download the @adb@ tool, the @adb.asc@ signature and the checksum from [[ReplicantImages]] for the latest image
2. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] to your GPG keyring
3. Check the signature of the @adb@ tool:
<pre>
gpg --armor --verify path/to/adb.asc path/to/adb
</pre>
4. Make sure the check succeeds, *do not run the binary if it doesn't*!
5. Check the checksum of the @adb@ tool:
<pre>
md5sum -c tools.md5
</pre>
6. Make sure the check succeeds for @adb@, *do not run the binary if it doesn't*!

As @adb@ is built as a 32 bit binary, you will need to install compatibility libraries for 32 bits executables if your computer is running on a 64 bit architecture.
7. Make sure @adb@ can be executed:
<pre>
chmod a+x adb
</pre>

h2. Fastboot

Fastboot can be installed from the repositories of your GNU/Linux distribution (if available) or from our released tools.
Note: you may need to run fastboot as root if your current user doesn't have USB access privileges.

h3. From GNU/Linux distributions repositories

h4. Debian

<pre>
apt-get install android-tools-fastboot
</pre>

h3. From our released tools

1. Download the @fastboot@ tool, the @fasboot.asc@ signature and the checksum from [[ReplicantImages]] for the latest image
2. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] to your GPG keyring
3. Check the signature of the @fastboot@ tool:
<pre>
gpg --armor --verify path/to/fastboot.asc path/to/fastboot
</pre>
4. Make sure the check succeeds, *do not run the binary if it doesn't*!
5. Check the checksum of the @fastboot@ tool:
<pre>
md5sum -c tools.md5
</pre>
6. Make sure the check succeeds for @fastboot@, *do not run the binary if it doesn't*!

As @fastboot@ is built as a 32 bit binary, you will need to install compatibility libraries for 32 bits executables if your computer is running on a 64 bit architecture.
7. Make sure @fastboot@ can be executed:
<pre>
chmod a+x fastboot
</pre>

h2. Heimdall

Heimdall can be installed from the repositories of your GNU/Linux distribution (if available), from our released tools or from the developer's website.
Note: you may need to run heimdall as root if your current user doesn't have USB access privileges.

h3. From GNU/Linux distributions repositories

h4. Debian

<pre>
apt-get install heimdall-flash
</pre>

h3. From our released tools

1. Download the @heimdall@ tool, the @heimdall.asc@ signature and the checksum from [[ReplicantImages]] for the latest image
2. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] to your GPG keyring
3. Check the signature of the @heimdall@ tool:
<pre>
gpg --armor --verify path/to/heimdall.asc path/to/heimdall
</pre>
4. Make sure the check succeeds, *do not run the binary if it doesn't*!
5. Check the checksum of the @heimdall@ tool:
<pre>
md5sum -c tools.md5
</pre>
6. Make sure the check succeeds for @heimdall@, *do not run the binary if it doesn't*!

As @heimdall@ is built as a 32 bit binary, you will need to install compatibility libraries for 32 bits executables if your computer is running on a 64 bit architecture.
7. Make sure @heimdall@ can be executed:
<pre>
chmod a+x heimdall
</pre>

h3. From the developer's website

Instructions to install heimdall can be found on the developer's website: http://glassechidna.com.au/heimdall/