🤖 Fdroid-auto

🔖 Table of contents

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

❓ 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 📱 phone and don't want to deal with the 🔁 repetitive task of 😱 bootloop while uninstalling because you didn't 🧠 remember it was an important package or manually downloading F-droid apks by typing them into the search bar 🔍 and then manually installing it.

📁 Installation

🐧 Binary dependencies (Unix)

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

🐍 Option 1: Pypi

python3 -m pip install fdroid-auto

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

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

💻 Usage

1. Enable USB Debugging on your Android device 📱
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

📋 Uninstalling

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

📋 Downloading

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

📋 Installing

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

🤝 Joined together

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

📄 Output

Uninstalling	Downloading	Installing

⚙️ 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.

📓 Notes

• ‼️ 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).

• 🛡️ 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 🔗 Sivefunc

Licensed under 🔗 GPLv3