mirror
/
fdroidcl
mirror of https://github.com/mvdan/fdroidcl.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
F-Droid desktop client
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
309 Commits
1 Branch
10 Tags
2.9 MiB
 
Tree: d9e1bb5f11
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'd9e1bb5f11'
${ noResults }
Daniel Martí d9e1bb5f11
rework README/-h usage text 		7 years ago
adb all: refactor to use the new JSON index format 8 years ago
basedir basedir: replace cache with os.UserCacheDir 7 years ago
contrib/completion/zsh contrib: update zsh completion 8 years ago
fdroid html unescape name strings from the index 7 years ago
testdata add install -u and -n flags 7 years ago
.gitignore add missing staticrepo index file 7 years ago
.travis.yml CI: test on 1.11 and 1.12, use modules 7 years ago
LICENSE Fix license wording 10 years ago
README.md rework README/-h usage text 7 years ago
defaults.go move main package into root directory 7 years ago
devices.go start rewriting tests with testscript 7 years ago
download.go allow downloads without adb installed 7 years ago
go.mod start rewriting tests with testscript 7 years ago
go.sum start rewriting tests with testscript 7 years ago
install.go add install -u and -n flags 7 years ago
list.go start rewriting tests with testscript 7 years ago
main.go rework README/-h usage text 7 years ago
main_test.go rewrite device tests with testscript 7 years ago
search.go start rewriting tests with testscript 7 years ago
show.go add install -u and -n flags 7 years ago
uninstall.go start rewriting tests with testscript 7 years ago
update.go add download test, refactor static repo 7 years ago

README.md

fdroidcl

GoDoc Build Status

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

go get -u 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

Commands

update                Update the index
search <regexp...>    Search available apps
show <appid...>       Show detailed info about an app
devices               List connected devices
download <appid...>   Download an app
install <appid...>    Install or upgrade app
uninstall <appid...>  Uninstall an app
defaults              Reset to the default settings

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