DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
Skip to content
Mountain View desk5 min

How to Get an Android App Listed on F-Droid: The Official Submission Steps

A practical guide to official F-Droid inclusion, from eligibility and release tags to fdroiddata metadata, review, server build, and publication.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To publish an Android app in F-Droid’s official repository, prepare a public, suitably licensed source project, add its build and listing details to fdroiddata, validate the metadata and build, then open a merge request and respond to review. A merged entry is not yet a published app: F-Droid’s server must still build it and add it to the repository. This guide covers official inclusion; running your own F-Droid-compatible repository is a separate distribution route.

1. Check whether the app is suitable for the official repository

Start with F-Droid’s inclusion quick-start guide and inclusion policy. The source repository should be public, contain the current real source code, and include an appropriate free and open-source software (FOSS) license. Check the app’s dependencies, build tools, bundled resources, and services—not just the license label.

As an Amazon Associate I earn from qualifying purchases.

F-Droid’s quick-start guide specifically identifies Firebase and Google Mobile Services as examples it does not accept in the official repository. If an app can work without them, a separate flavor that excludes them may be an option. If you are submitting on behalf of someone else, notify the author and obtain their non-objection.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Review may consider license notices, binary blobs, non-free assets or dependencies, advertising, tracking, and reliance on services users cannot change or avoid. F-Droid may ask for changes, document AntiFeatures, determine how updates will be handled, and try to build the app in an isolated environment. An open-source label alone does not guarantee acceptance.

#1 Best Overall
Samsung Galaxy A16 4G LTE (128GB + 4GB) International Model SM-A165F/DS Factory Unlocked, 6.7", Dual SIM, 50MP Triple Camera (Case Bundle), Black
  • Please note, this device does not support E-SIM; This 4G model is compatible with all GSM networks worldwide outside of the U.S. In the US, ONLY compatible with T-Mobile and their MVNO's (Metro and Standup). It will NOT work with other CDMA carriers, and it is also not compatible with their MVNO (Visible, Xfinity Mobile, US Mobile, Cricket Wireless, etc).
  • Compatibility with certain third-party devices and accessibility accessories, including some hearing aids, may vary depending on manufacturer support, Bluetooth protocols, software compatibility, and regional firmware limitations. For additional hearing aid compatibility information, please refer to Samsung’s official support documentation.
  • Camera: 50 MP, f/1.8, (wide), 1/2.76", 0.64µm, AF | 50 MP, f/1.8, (wide), 1/2.76", 0.64µm, AF | 2 MP, f/2.4, (macro). Battery: 5000 mAh, non-removable | A power adapter is NOT included.

2. Prepare tagged releases and app-listing material

Make sure each release you want F-Droid to build has a Git tag corresponding to its version. Prepare the app’s listing information upstream, using a supported metadata layout. F-Droid’s quick-start guide describes localized metadata that can include short and full descriptions, an icon, phone screenshots, and a changelog for a specific version.

  • The short description must be under 80 characters and should not end with a period.
  • The changelog may be up to 500 characters.

If the listing material is missing, ask the app team to add it to the upstream project. Keeping it with the app makes it easier for the team to maintain.

3. Create the fdroiddata metadata entry

The official repository’s app records live in fdroiddata. Fork that repository, create a submission branch, and add a YAML file at metadata/<application-id>.yml, using the app’s exact Android application ID in the filename. F-Droid’s quick-start guide suggests starting from a similar app or a template; fdroid import can generate a template.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
Samsung Galaxy A17 5G Smart Phone 128GB US 1 Yr Manufacturer Warranty Black | Large AMOLED, High-Res Camera, Durable Design, Super Fast Charging, Expandable Storage, Circle to Search, 2025
  • YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
  • LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
  • MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
  • NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
  • BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.

The metadata identifies the app, its public source location, and how a particular version is built. Consult F-Droid’s build metadata reference for the supported fields. A Git Repo must be an unauthenticated public HTTPS URL, and a build block’s commit must be a full commit hash—not a branch name or tag.

Set up a build block for the project’s toolchain

A build block ties a version name and version code to a source revision and its build settings. For a Gradle project, specify the needed module or subdirectory and the appropriate flavor or task. The cited quick-start instructions principally describe Gradle projects; apps built with other toolchains need explicit build instructions and an output path that lets fdroidserver find the APK. Do not assume one set of commands fits every Android project.

4. Configure update detection and make an informed signing choice

When the version name and version code are in standard Gradle or manifest locations, F-Droid may detect new versions without extra extraction settings. If the project stores version information elsewhere, configure the metadata’s update-check fields to match its release scheme. The quick-start guide recommends automatic update checks unless there is a reason to manage updates manually.

Rank #3
Tracfone Motorola Moto G 2025, 64GB, Saphire Blue (Locked to | Prepaid Smartphone- 6.6" 120Hz Display, 5G , 50MP Quad Pixel Camera, Long-Lasting Battery
  • Carrier: This phone is locked to Tracfone, which means this device can only be used on the Tracfone wireless network. Tracfone plan required, activating is easy, just 3 steps.
  • DISPLAY: Immersive viewing on a 6.7-inch super-bright 120Hz display with powerful stereo speakers and Bass Boost for cinematic entertainment.
  • CAMERA SYSTEM: Advanced 50MP Quad Pixel camera captures sharp, detailed photos and videos in any lighting condition
  • PERFORMANCE: Lightning-fast 5G connectivity paired with a powerful processor and RAM Boost for smooth multitasking.
  • BATTERY LIFE: Long-lasting 5000mAh battery with TurboPower charging technology delivers hours of power in minutes.

Reproducible builds are recommended, not mandatory

F-Droid states in its quick-start guide: “Reproducible builds are not a requirement for apps being on F-Droid. But we do consider their use best practice.” Reproducibility lets F-Droid compare a binary with the build produced from source and the build recipe.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

F-Droid documents options involving developer-signed binaries or F-Droid-signed builds. If metadata is configured to use upstream developer-signed binaries, F-Droid verifies them against the build recipe; when verification does not match, that version is skipped rather than published. Discuss the signing plan early: Android signing-key constraints can make a later change disruptive for existing users. See F-Droid’s reproducible builds documentation for the relevant process.

5. Validate the metadata and build before submission

Use fdroidserver as appropriate for your development environment. The quick-start guide names these checks:

Rank #4
Samsung Galaxy A17 5G Smart Phone 128GB, US 1 Yr Manufacturer Warranty Blue | Large AMOLED, High-Res Camera, Durable Design, Super Fast Charging, Expandable Storage, Circle to Search, 2025
  • YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
  • LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
  • MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
  • NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
  • BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.
  1. Run fdroid lint <appid> to identify metadata issues.
  2. Run fdroid rewritemeta <appid> to format the metadata.
  3. Build the app using the metadata and inspect the logs for errors.

You can also push the branch to your fork so its CI can validate the metadata. Fix failures and review the resulting logs before asking maintainers to review the submission. These checks do not replace F-Droid’s own review and build.

The quick-start guide gives a historical setup estimate of 2 GB of network traffic and 5 GB of disk space for a laptop running Ubuntu 21.10 in February 2022. Those dated figures describe that example environment, not current universal hardware requirements.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

6. Open a merge request and respond to review

Commit and push the metadata branch to your fork, then open a merge request against the fdroiddata repository. F-Droid’s developer FAQ describes this as the quickest route to official repository inclusion.

Best Value
Sale
Samsung Galaxy A16 5G 128GB Cell Phone, Unlocked Android Smartphone, Large AMOLED Display, Durable Design, Super Fast Charging, Expandable Storage, US Version, 2025, Blue Black (Renewed)
  • Charger NOT Included, 6.7" Super AMOLED FHD+, 90Hz Refresh Rate, 385 ppi, 800 nits (HBM), 1080x2340px, 5000mAh Battery
  • 128GB, 4GB RAM, microSDXC, Exynos 1330 (5nm), Octa-Core, Mali-G68 MP2 or Mali-G57 MC2 GPU
  • Rear Camera: 50MP, f/1.8 (wide) + 5MP, f/2.2 (ultrawide) + 2MP, f/2.4 (macro), LED flash, panorama, HDR; Front Camera: 13MP, f/2.0, Android 14, up to 6 major Android upgrades, One UI 6.1
  • 3G: HSDPA 850/900/1700(AWS)/1900/2100; 4G LTE: 1/2/3/4/5/7/12/13/14/20/25/26/28/29/30/38/39/40/41/48/66/71, 5G: 2/5/25/41/66/71/77/78 SA/NSA/Sub6/mmWave - Nano-SIM + eSIM
  • US Model – Global Connectivity – Compatible with Most GSM Carriers like T-Mobile, AT&T, MetroPCS, etc. Will Also work with CDMA Carriers Such as Verizon, Straight Talk.

Watch the merge request thread and answer packager questions. Reviewers assess both the software’s freedom and whether the documented build works; they may request fixes to metadata, source, dependencies, or build instructions. Acceptance into fdroiddata is an important review milestone, but it is not the same as the app appearing in the F-Droid client.

7. Track the server build and repository publication

After metadata is accepted, F-Droid’s build server fetches the source and required components, builds the app, and publishes it to the official repository if the process succeeds. Check the app’s page and build log, and consult the F-Droid monitor for current or recent failures.

F-Droid’s quick-start guide gives an approximate 24–48-hour interval from metadata merge to repository appearance when there are no build problems. It is not a guaranteed deadline: build cycles are unscheduled and apps are processed in batches. The website listing may also lag behind repository availability while pages are generated.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

When a self-hosted repository makes more sense

If you want to distribute APKs without seeking inclusion in F-Droid.org’s official collection, F-Droid documents how to run a separate repository. Its repository setup guide describes placing APKs in a repository directory, running fdroid update --create-metadata, and serving the generated contents over the web. That route puts repository hosting and operation in your hands; it is not an alternate way to receive official approval.

The guide’s quick test configuration is not a secure production setup. A public repository needs the stronger setup described in F-Droid’s security guidance.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.