APyK 0.0.2
APyK is a program with which you will be able to backup your applications from your computer.
License: MIT
Requires Python: >=3.5
Keywords: adb android apk backup apps

## APyK - APK Backup

APyK is a program with which you will be able to backup your applications from your computer, **FREE** and better yet **WITHOUT BEING ROOT**. Without further ado, let's get started.

## 💻 - Pre-requisites

Have basic knowledge of **ADB (Android Debug Bridge)**, you will need to install it, add it to the environment variables and authorize your computer to access the device.

APyK was tested and programmed with **ADB version 1.0.32 Revision eac51f2bb6a8-android**.



## 🐍 - Installation from Python

You can use **APyK** from Python.

```bash
pip install APyK
```

After install type **apyk** and press **Enter**

<p align="center"><b>OR</b></p>

## ⬇️ - Download executable

Download the latest version of **APyK** for **Windows** from [**HERE**](https://github.com/Jalkhov/apyk/releases/latest). After downloading extract and run the **apyk.exe** file located in the extracted folder. You will see many command line windows opening and closing in some processes, we will see if we can suppress them in future versions.

## 📘 - Usage

<details>
  <summary>🔽 <span style="color:red"><b>Click here to expand tutorial!</b></span> 🔽</summary>

##### 👀 Remember

* Have ADB added to the system environment variables.
* Have granted permissions to the computer to access the device.
* Have the device in debug mode.
* And (of course), have the device connected to the computer via USB.

##### 🔎 App name lookup

![1.Name_Lookup](https://i.imgur.com/E15SW4e.png)

This warning is due to the fact that when listing the applications installed on your device they will look approximately as follows:

```text
org.telegram.messenger
com.whatsapp
com.facebook.lite
```

Each app in the playstore has a **unique ID**, and these are the ones that will be displayed in the list of apps, as you can see there are some that can be easily identified, however there are others whose IDs have nothing to do with the original name and for some people it is difficult to know which app corresponds, such as **Tik Tok**:

```text
com.zhiliaoapp.musically
```

Anyway, returning to the main point, if we decide to activate the option in question, APyK will look for the real name of the app based on the ID of this, and it will go from looking like we showed it before to look like this:

```text
org.telegram.messenger | Telegram
com.whatsapp | WhatsApp Messenger
com.facebook.lite | Facebook Lite
com.zhiliaoapp.musically | Tik Tok
```

Please note that this option requires an internet connection, and depending on the speed of the internet connection the list of applications will be loaded.

**NOTE**: As it says in the warning, apps that do not belong to the Play Store will not be affected, since as I mentioned before, the search is done based on the ID with which the app is registered.

At once I say that this option is courtesy of the library [**google-play-scraper**](https://github.com/JoMingyu/google-play-scraper), credits to its creator.

##### 🖥️ Main Screen

Once you have made a decision regarding the above option, if you have the above **[HERE](#-remember)**, the program will automatically start searching for the installed applications, and if everything went well, it will display the respective list.

![2.Main_Screen](https://i.imgur.com/vkgHYCo.png)

On the main screen we have (for now):

* ID of the detected device
* Field to filter the listed applications
* List of applications
* And some very obvious buttons

A very intuitive interface, isn't it? Simple just select with a click the applications you want to back up, you can also use the filter bar to find more quickly those applications of which you have a notion of the name that has its package ID. Like the example you will see below:

![3.Filter](https://i.imgur.com/BqZ9v16.png)

When you select the applications the interface will change, and a new list will appear with the applications you have selected and the button to proceed with the backup.

![4.Selected_Packages](https://i.imgur.com/l4Y8W0y.png)

Once you are satisfied with your selection, press the **Backup** button. You will instantly be prompted to browse and select the destination directory for the apks to be backed up. Note that if you cancel the directory selection, the backup process will also be cancelled. Once you have selected the destination directory the backup process will start, and at the end you will see the following screen:

![6.Results](https://i.imgur.com/8m1hNFg.png)

(For now) the resulting file names will be the package IDs of each application, so our final directory would look like this:

![7.Folder.PNG](https://i.imgur.com/Jla0xbD.png)

</details>

## 💡- TODO

* Restore or install APKs
* Save each backed up apk with its application name (if available)
* Support for other operating systems (Do you want to contribute?)



## 💪 - Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.



## 📝 - License
[MIT](https://choosealicense.com/licenses/mit/)