{"id":16833841,"url":"https://github.com/mvdan/fdroidcl","last_synced_at":"2025-04-06T17:11:29.486Z","repository":{"id":30198235,"uuid":"33749093","full_name":"mvdan/fdroidcl","owner":"mvdan","description":"F-Droid desktop client","archived":false,"fork":false,"pushed_at":"2023-09-13T13:41:03.000Z","size":1896,"stargazers_count":279,"open_issues_count":10,"forks_count":22,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-03-30T16:11:50.925Z","etag":null,"topics":["android","client","fdroid"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mvdan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"mvdan"}},"created_at":"2015-04-10T20:25:32.000Z","updated_at":"2025-03-13T17:16:11.000Z","dependencies_parsed_at":"2024-06-18T18:23:01.800Z","dependency_job_id":"1ddfe7ed-f216-44a4-be8c-e549c7251d4f","html_url":"https://github.com/mvdan/fdroidcl","commit_stats":{"total_commits":359,"total_committers":7,"mean_commits":"51.285714285714285","dds":0.1615598885793872,"last_synced_commit":"b06a74456c74f451d94ad8684e9b6bdf7313a4b3"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvdan%2Ffdroidcl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvdan%2Ffdroidcl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvdan%2Ffdroidcl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvdan%2Ffdroidcl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mvdan","download_url":"https://codeload.github.com/mvdan/fdroidcl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247517912,"owners_count":20951718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","client","fdroid"],"created_at":"2024-10-13T11:55:25.337Z","updated_at":"2025-04-06T17:11:29.462Z","avatar_url":"https://github.com/mvdan.png","language":"Go","funding_links":["https://github.com/sponsors/mvdan"],"categories":[],"sub_categories":[],"readme":"# fdroidcl\n\n[![GoDoc](https://godoc.org/github.com/mvdan/fdroidcl?status.svg)](https://godoc.org/mvdan.cc/fdroidcl)\n\n[F-Droid](https://f-droid.org/) desktop client. Requires Go 1.19 or later.\n\n\tgo install mvdan.cc/fdroidcl@latest\n\nWhile the Android client integrates with the system with regular update checks\nand notifications, this is a simple command line client that talks to connected\ndevices via [ADB](https://developer.android.com/tools/help/adb.html).\n\n### Quickstart\n\nDownload the index:\n\n\tfdroidcl update\n\nShow all available apps:\n\n\tfdroidcl search\n\nInstall an app:\n\n\tfdroidcl install org.adaway\n\nShow all available updates, and install them:\n\n\tfdroidcl search -u\n\tfdroidcl install -u\n\nUnofficial packages are available on: [Debian](https://packages.debian.org/buster/fdroidcl) and [Ubuntu](https://packages.ubuntu.com/eoan/fdroidcl).\n\n### Commands\n\n\tupdate                   Update the index\n\tsearch [\u003cregexp...\u003e]     Search available apps\n\tshow \u003cappid...\u003e          Show detailed info about apps\n\tinstall [\u003cappid...\u003e]     Install or upgrade apps\n\tuninstall \u003cappid...\u003e     Uninstall an app\n\tdownload \u003cappid...\u003e      Download an app\n\tdevices                  List connected devices\n\tlist (categories/users)  List all known values of a kind\n\trepo                     Manage repositories\n\tclean                    Clean index and/or cache\n\tdefaults                 Reset to the default settings\n\tversion                  Print version information\n\n\nAn appid is just an app's unique package name. A specific version of an app can\nbe selected by following the appid with a colon and the version code. The\n'search' and 'show' commands can be used to find these strings. For example:\n\n\t$ fdroidcl search redreader\n\t$ fdroidcl show org.quantumbadger.redreader\n\t$ fdroidcl install org.quantumbadger.redreader:85\n\n### Config\n\nYou can configure what repositories to use in the `config.json` file. On Linux,\nyou will likely find it at `~/.config/fdroidcl/config.json`.\n\nYou can run `fdroidcl defaults` to create the config with the default settings.\n\n#### *new: you can manage the repositories now directly via cli*\n\n```\nusage: fdroidcl repo\n\nList, add, remove, enable or disable repositories.\nWhen a repository is added, it is enabled by default.\n\nList repositories:\n\n        $ fdroidcl repo\n\nModify repositories:\n\n        $ fdroidcl repo add \u003cNAME\u003e \u003cURL\u003e\n        $ fdroidcl repo remove \u003cNAME\u003e\n        $ fdroidcl repo enable \u003cNAME\u003e\n        $ fdroidcl repo disable \u003cNAME\u003e\n```\n\n### Advantages over the Android client\n\n* Command line interface\n* Batch install/update/remove apps without root nor system privileges\n* No need to install a client on the device\n\n### What it will never do\n\n* Run as a daemon, e.g. periodic index updates\n* Act as an F-Droid server\n* Swap apps with devices\n\n### Caveats\n\n* Index verification relies on HTTPS (not the JAR signature)\n* The tool can only interact with one device at a time\n* Hardware compatibility of packages is not checked\n\n### FAQ\n\n* What's the point of a desktop client?\n\nThis client works with Android devices connected via ADB; it does not install\napps on the host machine.\n\n* Why not just use the f-droid.org website to download APKs?\n\nThat's always an option. However, an F-Droid client supports multiple\nrepositories, searching for apps, filtering by compatibility with your device,\nshowing available updates, et cetera.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvdan%2Ffdroidcl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmvdan%2Ffdroidcl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvdan%2Ffdroidcl/lists"}