# Install fdroidcl with Homebrew, apt, Nix, winget

F-Droid desktop client. Version 0.8.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:fdroidcl
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install fdroidcl
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install fdroidcl
```

  Evidence: Debian stable package indexes: fdroidcl from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#fdroidcl
```

  Evidence: nixpkgs package indexes: pkgs/by-name/fd/fdroidcl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id Hoverth.fdroidcl -e
```

  Evidence: Windows Package Manager source index: Hoverth.fdroidcl from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:fdroidcl
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/fdroidcl>
- **Version:** 0.8.1
- **Source summary:** F-Droid desktop client
- **Homepage:** <https://github.com/Hoverth/fdroidcl>
- **Repository:** <https://github.com/Hoverth/fdroidcl>
- **Upstream docs:** <https://github.com/Hoverth/fdroidcl#readme>
- **License:** BSD-3-Clause
- **Source archive:** <https://github.com/Hoverth/fdroidcl/archive/refs/tags/v0.8.1.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- fdroidcl (cli)
- fdroidcl (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.8.1
- Local data: ok
- Upstream repository: https://github.com/Hoverth/fdroidcl
- Upstream latest detected: v0.8.1 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

fdroidcl is a command-line desktop client for F-Droid. It is not an F-Droid repository server and it is not a replacement Android app store UI; it is a host-side tool that talks to connected Android devices over ADB and operates on F-Droid repositories from a terminal.

### Project history

The fdroidcl repository was created in 2015 and its README presents the tool as a simple command-line client for F-Droid. The README contrasts it with the Android client: the Android client integrates with the device for update checks and notifications, while fdroidcl runs on the desktop and uses ADB.

The project grew from basic index, search, install, uninstall, and download operations into a broader CLI that can manage repositories and setups. The README documents commands for updating indexes, searching apps, installing updates, scanning connected devices, managing repositories, and creating setup definitions for mass installs.

### Adoption history

The supplied package facts show fdroidcl distributed by Homebrew, Debian, Ubuntu, Nix, and winget. That spread is notable for a small F-Droid companion tool: it means the CLI is useful outside a single Linux packaging niche and has become a recognizable bridge between desktop package managers, Android devices, and F-Droid repositories.

The README notes unofficial Debian and Ubuntu packages, while the current package facts show wider packaging. Its adoption is tied to users who manage multiple Android devices, prefer scripted installs, or want F-Droid repository access without installing the Android F-Droid client on every device first.

### How it is used

The normal workflow is to run fdroidcl update to download repository indexes, search or show app metadata, and then install or upgrade packages on a connected device. Repository management and setup export/import make it useful for repeatable device provisioning.

The README also documents clear limits: fdroidcl does not run as a daemon, does not act as an F-Droid server, and does not swap apps with devices. Those boundaries make it a focused CLI rather than a general F-Droid platform.

### Why package nerds care

fdroidcl is interesting because it turns F-Droid into something closer to a traditional package-manager CLI. For package nerds, app IDs, repository indexes, repeatable installs, and ADB-backed device operations make Android app management feel closer to apt, brew, or pacman workflows.

### Timeline

- 2015: GitHub repository created and early v0.1.0 tag history appears.
- 2025: v0.8.1 tag history shows ongoing maintenance.
- 2026: README requires Go 1.21 or later and documents repository and setup management commands.

### Related projects

- F-Droid is the upstream app distribution ecosystem whose repositories fdroidcl consumes.
- ADB is the Android device bridge fdroidcl uses to operate on connected devices.
- fdroidserver is the complementary tool suite for creating and maintaining F-Droid repositories.

### Sources

- <https://github.com/Hoverth/fdroidcl>
- <https://raw.githubusercontent.com/Hoverth/fdroidcl/master/README.md>
- <https://api.github.com/repos/Hoverth/fdroidcl>
- <https://formulae.brew.sh/formula/fdroidcl>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ~/.config/fdroidcl/config.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** fdroidcl
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - fdroidcl - 0.7.0-1+b11: normalized package name match | Debian stable package indexes: fdroidcl from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | F-Droid desktop client | https://github.com/mvdan/fdroidcl
- Debian apt - golang-github-mvdan-fdroidcl-dev - 0.7.0-1: normalized package name match | Debian stable package indexes: golang-github-mvdan-fdroidcl-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | fdroidcl develpoment files | https://github.com/mvdan/fdroidcl
- Nix - fdroidcl: normalized package name match | nixpkgs package indexes: pkgs/by-name/fd/fdroidcl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - fdroidcl - 0.7.0-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: fdroidcl from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | F-Droid desktop client | https://github.com/mvdan/fdroidcl
- Ubuntu apt - golang-github-mvdan-fdroidcl-dev - 0.7.0-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: golang-github-mvdan-fdroidcl-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | fdroidcl develpoment files | https://github.com/mvdan/fdroidcl
- winget - Hoverth.fdroidcl: normalized package name match | Windows Package Manager source index: Hoverth.fdroidcl from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [fdroidserver](https://www.automicvault.com/pkg/brew/fdroidserver/) - Shares av.db curated category or tags: android, cli, developer-tools, fdroid.
- [adb-enhanced](https://www.automicvault.com/pkg/brew/adb-enhanced/) - Shares av.db curated category or tags: android, cli, developer-tools.
- [bundletool](https://www.automicvault.com/pkg/brew/bundletool/) - Shares av.db curated category or tags: android, cli, developer-tools.
- [dex2jar](https://www.automicvault.com/pkg/brew/dex2jar/) - Shares av.db curated category or tags: android, cli, developer-tools.
- [payload-dumper-go](https://www.automicvault.com/pkg/brew/payload-dumper-go/) - Shares av.db curated category or tags: android, cli, developer-tools.
- [pidcat](https://www.automicvault.com/pkg/brew/pidcat/) - Shares av.db curated category or tags: android, cli, developer-tools.
- [purr](https://www.automicvault.com/pkg/brew/purr/) - Shares av.db curated category or tags: android, cli, developer-tools.
- [redex](https://www.automicvault.com/pkg/brew/redex/) - Shares av.db curated category or tags: android, cli, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/fdroidcl.yml](https://github.com/automic-vault/db/blob/main/combined/fdroidcl.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
