viettelpost-patch/README.md

# ViettelPost Patcher for Android

The first open source patch for a delivery goods app in Vietnam, made by Cuynu with love (and no coding skill/knowledge) <3

My aims is to improve original ViettelPost app, remove annoying features like startup animation, first startup ugly video which literally make your mom mad and more :>

Licensed as MIT License.

## Requirements
- Any actual Linux environment (Arch Linux based recommended)
- No support for macOS & WSL & Termux.
- Little knowledge about terminal commands
- `android-tools` `wget` for Arch/Fedora based and `android-sdk-platform-tools` for Debian based
- `git` installed
- `java` or `jdk-openjdk` installed
- `figlet` for showing banner (optional)

## Usage
- Go to home directory, then clone repository first
```
cd ~
git clone https://git.disroot.org/cuynu/viettelpost-patch.git
cd ~/viettelpost-patch/vtp
```

- Grab ViettelPost APKm from [APKMirror](https://www.apkmirror.com/apk/viettel-media-inc/viettel-post/) and copy it to `~/viettelpost-patch/vtp/vtpapk/`

- Run bash `vtp.sh` script
```
cd ~/viettelpost-patch/vtp
./vtp.sh
```
- Download necessary tools first with `Download tools` function (otherwise other functions are unlikely to work!)
- Convert apks to apk first using `Convert apkm to apk` function
- Unpack apk with `Unpack apk` function
- Use `Patch App` function and select the patches you want to apply to unpacked app
- When done, use `Repack APK` function to recompile patched app
- Patched app will be `ViettelPost_SelfPatched.apk` on `~/viettelpost-patch/vtp/vtpout_apk/`
- Install with adb or use `5) Install patched app` option
- Profit :)


## Patches list :
### [📦 `ViettelPost : com.viettel.ViettelPost`](https://www.apkmirror.com/apk/viettel-media-inc/viettel-post/)
<details>

| ⚙️ Patch | 📜 Description | 🏦 Suggested version |
|:--------:|:--------------:|:-----------------:|
| `Remove first startup introduction video` | Remove the introduction video on first startup, which is ugly and might affect other peoples. | Unlimited |
| `Remove loading video animation` | Remove the loading video animation when opening app (ViettelPost with love heart and VIPO). | Unlimited |


</details>

## External projects 
ViettelPost Patcher project won't be possible without those external projects !!
- [apktool](https://github.com/iBotPeaches/Apktool)
- [APKEditor](https://github.com/REAndroid/APKEditor/)
- [uber-apk-signer](https://github.com/patrickfav/uber-apk-signer)