F-Droid Client

Client for F-Droid, the Free Software repository system for Android.

Building from source

The only required tools are the Android SDK and Apache Ant.

Once you have checked out the version you wish to build, run:

git submodule update --init
cd F-Droid
./ant-prepare.sh # This runs 'android update' on the libs and the main project
ant clean release

The project itself supports Gradle, but some of the libraries it uses don’t. Hence it is currently not possible to build F-Droid with Gradle in a clean way without manual interaction.

Direct download

You can download the application directly from our site or browse it in the repo.


You are welcome to submit Merge Requests via the Gitlab web interface. You can also follow our Issue tracker and our Forums.


The res/values-* dirs are kept up to date automatically via MediaWiki’s Translate Extension. See our translation page if you would like to contribute.

Running the test suite

FDroid client includes a embedded Android Test Project for running tests. It is in the test/ subfolder. To run the tests from the command line, do:

git submodule update --init
./ant-prepare.sh # This runs 'android update' on the libs and the main project
ant clean emma debug install test

You can also run the tests in Eclipse. Here’s how:

  1. Choose File -> Import -> Android -> Existing Android Code Into Workspace for the fdroidclient/ directory.
  2. Choose File -> Import -> Android -> Existing Android Code Into Workspace for the fdroidclient/test/ directory
  3. If fdroid-test has errors, right-click on it, select Properties, the Java Build Path, then click on the Projects tab.
  4. Click on the Add… button and select fdroidclient/
  5. Right-click on the fdroid-test project, then Run As… -> Android JUnit Test


When building F-Droid, the following error may occur:

Invalid file: extern/UniversalImageLoader/library/build.xml

Check the output of the ./ant-prepare.sh command. This error is often accompanied by the following message:

Error: The project either has no target set or the target is invalid. Please provide a –target to the ‘android update’ command.

The most likely cause of this is that your installed Android SDK is missing the target version specified by one of the dependencies. For example, at the time of writing this, UniversalImageLoader uses the “android-16” target API, however the default install of the Android SDK will usually only install the latest version (“android-20” as of writing). So you will have to install missings “android-xx” targets via the SDK manager. To get a list of already installed SDK targets, run:

$ android list targets

To get a list of targets used by fdroidclient libs, run:

$ for i in $(grep "android.library.reference" project.properties | cut -f2 -d'='); do
grep ^target $i/project.properties | cut -f2 -d'=';
done | sort | uniq | paste -s -d',' -

to install missing or all needed targets, for example “android-16” and “android-7” run:

$ android update sdk -u -t "android-16,android-7"

NOTE: While it may be tempting to add “–target=android-19” to the ant-prepare.sh script, it is not the correct solution. Although it may work, it can cause strange bugs at runtime.


This program is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Related Repositories



A library that checks for your apps' updates on Google Play, GitHub, Amazon, F-Droid or your own server. API 8+ required. ...



Fossdroid Core is a web frontend of F-Droid: an alternative software repository comprising only free, open source software for Android. This repo is the open source version of fossdroid.com. ...



iodine for android (4+), available on http://f-droid.org ...



Eutopia.cz F-Droid Repository ...



F-Droid desktop client ...

Top Contributors

mvdan CiaranG eighthave pserwylo tunedal dschuermann pfalcon andrewgaul keverets alekseyt rieve Alexander-- cpu mator jancborchardt macno alexander-b iugrina AltNico


-   db-version/41 zip tar
-   db-version/40 zip tar
-   db-version/39 zip tar
-   db-version/37 zip tar
-   db-version/35 zip tar
-   db-version/34 zip tar
-   db-version/33 zip tar
-   db-version/32 zip tar
-   db-version/31 zip tar
-   db-version/30 zip tar
-   db-version/29 zip tar
-   db-version/28 zip tar
-   db-version/27 zip tar
-   db-version/26 zip tar
-   db-version/25 zip tar
-   db-version/24 zip tar
-   db-version/23 zip tar
-   db-version/22 zip tar
-   db-version/21 zip tar
-   db-version/20 zip tar
-   db-version/19 zip tar
-   db-version/18 zip tar
-   db-version/17 zip tar
-   db-version/16 zip tar
-   0.62 zip tar
-   0.61-test zip tar
-   0.60-test zip tar
-   0.59-test zip tar
-   0.58 zip tar
-   0.57-test zip tar