README

F-Droid Client




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

 Building with Gradle

    ./gradlew assembleRelease

 Direct download

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

 Coding style

This project uses ktfmt and enforces it via CI.
You can run the following to auto-format your changes:

    ./gradlew ktfmtFormat

 Libraries

Core F-Droid functionality is split into re-usable libraries
to make using F-Droid technology in your own projects as easy as possible.

More information about libraries

 Contributing

See our Contributing doc for information on how to report
issues, translate the app into your language or help with development.

 IRC

We are on fdroid and fdroid-dev on OFTC. We hold weekly dev meetings
on fdroid-dev on Thursdays at 11:30h UTC, which usually last half an hour.

 FAQ

 Why does F-Droid require "Unknown Sources" to install apps by default?

Because a regular Android app cannot act as a package manager on its
own. To do so, it would require system privileges (see below), similar
to what Google Play does.

 Can I avoid enabling "Unknown Sources" by installing F-Droid as a
  privileged system app?

This used to be the case, but no longer is. Now the Privileged
Extension is the one that should be placed in
the system. It can be bundled with a ROM or installed via a zip.

 License

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.

Some icons are made by Picol,
Icomoon or
Dave Gandy from
Flaticon or by Google and are licensed by
Creative Commons BY 3.0.

Other icons are from the
Material Design Icon set
released under an
Attribution 4.0 International license.


 Translation

Everything can be translated.  See
Translation and Localization
for more info.