Metadata-Version: 2.1
Name: fdpm
Version: 0.0.5
Summary: Command line tool to install packages from f-droid.org
Home-page: https://gitlab.com/kshib/fdpm
License: AGPL-3.0-only
Author: Kshitij Bhuwad
Author-email: ksyko@pm.me
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: beautifulsoup4 (>=4.10.0,<5.0.0)
Requires-Dist: pythondialog (>=3.5.3,<4.0.0)
Requires-Dist: requests (>=2.27.1,<3.0.0)
Requires-Dist: tqdm (>=4.63.0,<5.0.0)
Description-Content-Type: text/markdown

# fdpm

F-Droid Package Manager
Install apps from f-droid through command line

## Requirements
- adb
- python

## Setup
- On android:
  - [Enable developer options](https://developer.android.com/studio/command-line/adb#Enabling)
  - [Optional but recommended] To connect adb on phone itself:
    - Install a terminal like [termux](https://f-droid.org/en/packages/com.termux/) 
    - Install [adb binaries](https://github.com/ShiSheng233/Termux-ADB)
    - Go to `Developer options` -> `Wireless debugging` -> Note the `IP address & Port`
    - Open termux and enter `adb connect ip.add.re.ss:port` (Enter IP address & Port noted in previous step)
  - Install [dummy installer apk](https://gitlab.com/kshib/fdpm/-/blob/main/fdroid-cli.apk)
    Or you could also build it yourself from [here](https://gitlab.com/kshib/fdpm-installer). Just keep the package name intact.
- On desktop:
  - Download and extract [platform tools](https://developer.android.com/studio/releases/platform-tools#downloads)
  - Add `adb` to your `PATH` (You should be able to access it from any directory)
  - If wireless adb is possible on your android, enter `adb connect ip.add.re.ss:port` (same way as in android steps)
  - If wireless is not possible, connect usb
  
## Installation
```
pip install fdpm
```

## Usage
````
# Search apps
fdpm -s launcher

# Install apps
fdpm -i org.videolan.vlc ch.deletescape.lawnchair.plah

# Uninstall apps
fdpm -n org.videolan.vlc ch.deletescape.lawnchair.plah

# Update installed apps
fdpm -u

# Use dialog interface to avoid using package names (Not supported on windows)
fdpm -d
````

Screenshots:
![dialog_demo](https://z.zz.fo/9DeTS.jpg "Dialog demo")

## Tested on
- Android 11
- 5.16.14-1-MANJARO

## License
GNU AFFERO GENERAL PUBLIC LICENSE


