Need help with fdroidcl?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

mvdan
131 Stars 18 Forks BSD 3-Clause "New" or "Revised" License 324 Commits 12 Opened issues

Description

F-Droid desktop client

Services available

!
?

Need anything else?

Contributors list

fdroidcl

GoDoc

F-Droid desktop client. Requires Go 1.14 or later.

go get mvdan.cc/fdroidcl

While the Android client integrates with the system with regular update checks and notifications, this is a simple command line client that talks to connected devices via ADB.

Quickstart

Download the index:

fdroidcl update

Show all available apps:

fdroidcl search

Install an app:

fdroidcl install org.adaway

Show all available updates, and install them:

fdroidcl search -u
fdroidcl install -u

Unofficial packages are available on: Debian and Ubuntu.

Commands

update                Update the index
search []  Search available apps
show        Show detailed info about an app
install []  Install or upgrade apps
uninstall   Uninstall an app
download    Download an app
devices               List connected devices
list (categories)     List all known values of a kind
defaults              Reset to the default settings
version               Print version information

An appid is just an app's unique package name. A specific version of an app can be selected by following the appid with a colon and the version code. The 'search' and 'show' commands can be used to find these strings. For example:

$ fdroidcl search redreader
$ fdroidcl show org.quantumbadger.redreader
$ fdroidcl install org.quantumbadger.redreader:85

Config

You can configure what repositories to use in the

config.json
file. On Linux, you will likely find it at
~/.config/fdroidcl/config.json
.

You can run

fdroidcl defaults
to create the config with the default settings.

Advantages over the Android client

  • Command line interface
  • Batch install/update/remove apps without root nor system privileges
  • No need to install a client on the device

What it will never do

  • Run as a daemon, e.g. periodic index updates
  • Act as an F-Droid server
  • Swap apps with devices

Caveats

  • Index verification relies on HTTPS (not the JAR signature)
  • The tool can only interact with one device at a time
  • Hardware compatibility of packages is not checked

FAQ

  • What's the point of a desktop client?

This client works with Android devices connected via ADB; it does not install apps on the host machine.

  • Why not just use the f-droid.org website to download APKs?

That's always an option. However, an F-Droid client supports multiple repositories, searching for apps, filtering by compatibility with your device, showing available updates, et cetera.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.