:robot: Fdroid-auto

:bookmark: Table of contents

1. About
2. Installation
3. Usage
4. Output
5. Options
6. Notes

:question: About

Fdroid-auto is a very little program that automates the process of uninstalling, downloading and installing F-droid apk's through ADB.

This is useful when doing Factory resets or changing of :iphone: phone and don't want to deal with the :repeat: repetitive task of :scream: bootloop while uninstalling because you didn't :brain: remember it was an important package or manually downloading F-droid apks by typing them into the search bar :mag: and then manually installing it.

:file_folder: Installation

:penguin: Binary dependencies (Unix)

sudo apt-get install python3 python3-pip python3-setuptools adb

:snake: Option 1: Pypi

python3 -m pip install fdroid-auto

:hand: Option 2: Git repository (Still connects to Pypi)

git clone https://codeberg.org/Sivefunc/fdroid_auto
cd fdroid_auto
python3 -m pip install .

:computer: Usage

1. Enable USB Debugging on your Android device :iphone:
2. Connect your Android device to the Host computer through the USB cable.
3. There are two files apps/uninstall.txt and apps/download.txt which are examples files you can download and use.

usage: fdroid_auto options

:clipboard: Uninstalling

fdroid_auto -u apps/uninstall.txt       # Uninstall packages listed.

:clipboard: Downloading

fdroid_auto -d apps/download.txt apps/  # Download packages listed
                                        # and saved them on apps/

:clipboard: Installing

fdroid_auto -i apps/                    # Install packages listed
                                        # on directory apps/

:handshake: Joined together

fdroid_auto.py -u apps/uninstall.txt \
               -d apps/download.txt apps/ \
               -i apps/

:page_facing_up: Output

Uninstalling	Downloading	Installing

:gear: Options

• -h, --help → show this help message and exit.
• -v, --version → show program's version number and exit.
• -u [FILE], --uninstall [FILE] → Uninstall ALL packages listed from FILE on device using adb.
• -d [FILE] [DIR], --download [FILE] [DIR] → Download ALL fdroid .apks listed from FILE and push them into DIR.
• -i [DIR], --install [DIR] → Install ALL packages .apk listed from DIR on device using adb.
• n, --notation → Shows how to format the FILE and exit.

:notebook: Notes

• :bangbang: The order of events occur in the following way:

  • Uninstall: adb shell pm uninstall -k --user 0
  • Download
  • Install: adb install

• Suggested versions are the ones downloaded (not the latest unstable? version).

• :shield: Official repository is the one being used.

• Third party repositories are not supported like Bromite

• Uninstall/Install of apps is not limited to only F-droid, if these are installed or on a directory respectively.

• I haven't tested ADB through Wi-Fi only USB.

• Manuals I used: man adb or adb shell pm

• Read the source code to know things are done, specially packages.py

• The -k option on uninstall preserves app data, so you can reinstall with install-existing and not lose data.

• I recommend when looking for files to uninstall instead of the traditional adb shell pm list packages use App Manager

Made by :link: Sivefunc

Licensed under :link: GPLv3