How to publish Godot 3 to F-Droid

22. April 2023

F-Droid is an awesome app that gives you access to thousands of Free and Open Source Software apps and games. It also respects your privacy, requires no login and lets you know if an app has anti-features like tracking, ads, proprietary assets or if it depends on the proprietary Google Play Services. If an app has ads or tracks you, it is marked as AntiFeatures.
AntiFeatures example
I was able to publish Ball2Box to F-Droid and here I will share the steps that are needed to do so.
Here you can find the published game.


To publish a Godot Engine game to F-Droid you'll need an Open Source game with the source code published on a public git repository. You also need a Gitlab account to create a merge request to the F-Droid Data repository or you can make an Application Proposal where others include your app.
In the documentation you can read how the inclusion works. You also need a metadata directory in your repo with some screenshots, a description and the changelogs of your game.
F-Droid builds its apps itself and all its dependencies completely from the source. That means that you need also to build the Godot Engine from its source code.
If you have other third party dependencies you have also to build them from the source code. My game doesn't have any other dependency than the Godot Engine, so if your game has some, you will have to extend the following build recipe with the steps to build your dependencies.
All the steps needed are written in a yaml build recipe file. The best is to follow the official F-Droid Developer documentation so you will follow always the latest and correct steps.

The Godot build recipe

Here the Godot build recipe. You can find the always up to date version on Gitlab
You'll also need a metadata directory and a exports_preset.cfg in the repo of you game. You can find mine on Github in the fdroid and metadata directories.

  - Games
License: AGPL-3.0-or-later
AuthorName: Simon Dalvai

Name: Ball2Box
AutoName: Ball2Box

RepoType: git

  - versionName: 2.2.6
    versionCode: 44
    commit: a9ec9a5f025542c27196a0f5b3507a652e05e907
      - apt-get update
      - apt-get install -y clang gettext pkg-config scons
    output: game/Ball2Box.apk
      - Godot@6fed1ffa313c6760fa88b368ae580378daaef0f0
      - mv fdroid/export_presets.cfg game/export_presets.cfg
      - sed -i 's/FDROID = false/FDROID = true/g' game/src/globals/
      - export HOME=$PWD
      - cp -R $$Godot$$ godot
      - keytool -genkey -v -keystore debug.keystore -storepass android -alias androiddebugkey
        -keypass android -dname "CN=Android Debug,O=Android,C=US"
      - mkdir -p ./.config/godot/
      - export SDK_PATH="export/android/android_sdk_path = \"$$SDK$$\""
      - export DEBUG_KEYSTORE_PATH="export/android/debug_keystore = \"$PWD/debug.keystore\""
      - echo '[gd_resource type="EditorSettings" format=2]' >> ./.config/godot/editor_settings-3.tres
      - echo "[resource]"  >> ./.config/godot/editor_settings-3.tres
      - echo $SDK_PATH >> ./.config/godot/editor_settings-3.tres
      - echo $DEBUG_KEYSTORE_PATH >> ./.config/godot/editor_settings-3.tres
      - echo 'export/android/debug_keystore_user = "androiddebugkey"' >> ./.config/godot/editor_settings-3.tres
      - echo 'export/android/debug_keystore_pass = "android"' >> ./.config/godot/editor_settings-3.tres
      - cd godot
      - scons -j `nproc` platform=server use_llvm=yes unix_global_settings_path=".."
      - export ANDROID_NDK_ROOT=$$NDK$$
      - scons -j `nproc` use_llvm=yes p=android target=release  unix_global_settings_path=".."
        android_arch=armv7 profile=fdroid/
      - scons -j `nproc` use_llvm=yes p=android target=release  unix_global_settings_path=".."
        android_arch=arm64v8 profile=fdroid/
      - pushd platform/android/java/
      - gradle generateGodotTemplates
      - popd
      - cd ..
      - mkdir -p ./.local/share/godot/templates/3.5.1.stable/
      - echo "3.5.1.stable" >> ./.local/share/godot/templates/3.5.1.stable/version.txt
      - cp godot/bin/android_release.apk ./.local/share/godot/templates/3.5.1.stable/
      - ./godot/bin/godot_server.* -v --path game --export Android Ball2Box.apk
      - find . -iname "*.apk"
      - echo "build end"
    ndk: r23c

AutoUpdateMode: Version
UpdateCheckMode: Tags
UpdateCheckData: fdroid/export_presets.cfg|version/code=(\d+)|.|version/name="([\d.]+)"
CurrentVersion: 2.2.6
CurrentVersionCode: 44

Every feedback is welcome

Feel free to write me an email at and comment on Mastodon or HackerNews.

Github button Codeberg button mastodon button RSS button Email button