From 235402ed238e5d7b9fefbbbcadf95996fa8264f2 Mon Sep 17 00:00:00 2001 From: YZBruh Date: Fri, 15 Aug 2025 12:45:15 +0300 Subject: [PATCH] Write a installing and usage etc. --- INSTALLING.md | 130 ++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 2 + USAGE.md | 83 -------------------------------- 3 files changed, 132 insertions(+), 83 deletions(-) create mode 100644 INSTALLING.md diff --git a/INSTALLING.md b/INSTALLING.md new file mode 100644 index 0000000..bb3dccc --- /dev/null +++ b/INSTALLING.md @@ -0,0 +1,130 @@ +# Installing And Using PMT via Termux or ADB + +This guide shows you how to use PMT with Termux and ADB. After that, you might want to read [USAGE.md](./USAGE.md)! + +## Using PMT via Termux + +This part of the guide explains how to download and install PMT with **Termux**. + +--- + +### 📋 Requirements +- Termux app from [F-Droid](https://f-droid.org/packages/com.termux) or [GitHub](https://github.com/termux/termux-app/releases). +- DO NOT INSTALL TERMUX FROM PLAY STORE! + +--- + +### 🚀 Step-by-Step Usage + +#### 1️⃣ Prepare Termux + +If you haven't already, it's highly recommended that you allow internal storage usage. After all, I'm sure you'll want to keep your backups/flashbacks, etc., there. +```bash +termux-setup-storage +``` + +#### 2️⃣ Install PMT + +You can easily install PMT with the ready-made script! +```bash +# Download PMT's installer script for termux +curl -LSs "https://raw.githubusercontent.com/ShawkTeam/pmt-renovated/refs/heads/main/manager.sh" > manager.sh + +# Start script! +bash manager.sh install + +# Now, PMT is ready for usage if no error occurred. Try running: +pmt --help +``` + +--- + +### Do you want to uninstall...? + +Only run script via this command: +```bash +bash manager.sh uninstall +``` + +--- + +## Using PMT via ADB + +This part of the guide will show you how to use the **static** version of Partition Manager Tool (`pmt-static`) on your Android device through **ADB**. +It’s written for beginners — no advanced knowledge needed. + +--- + +### 📦 Why Static Version? +The **static** build of PMT contains everything it needs inside one single file. +This means you can run it directly on your Android device **without** installing extra libraries. +Perfect for quick tasks via ADB. + +--- + +### 📋 Requirements +- **ADB installed** on your computer + (Part of the Android SDK Platform Tools — [Download here](https://developer.android.com/studio/releases/platform-tools)) +- **USB Debugging enabled** on your phone + (Settings → Developer options → Enable USB debugging) +- Your **phone connected via USB** and recognized by ADB + +--- + +### 🚀 Step-by-Step Usage + +#### 1️⃣ Get the Correct Binary +Download the **`pmt-static`** file that matches your device’s architecture: +- **`pmt-static-arm64-v8a`** → For 64-bit devices +- **`pmt-static-armeabi-v7a`** → For 32-bit devices + +Unzip the downloaded `.zip` file — you should now have a `pmt` binary. + +--- + +#### 2️⃣ Push the Binary to Your Device +Use ADB to copy the `pmt` file to your phone’s temporary folder: +```bash +# Rename for more easily usage +mv pmt_static pmt + +adb push pmt /data/local/tmp/pmt +``` + +#### 3️⃣ Open an ADB Shell +Access your device shell: +```bash +adb shell +``` + +#### 4️⃣ Change to the Directory +Move into the temporary directory where pmt is stored: +```bash +cd /data/local/tmp +``` + +#### 5️⃣ Give Execute Permission +Allow the binary to be executed: +```bash +chmod 755 pmt +``` + +#### 6️⃣ Run PMT +You can now run PMT directly from this directory: + +```bash +# Open root terminal +su + +./pmt --help +``` +Example — Back up the boot partition: + +```bash +./pmt backup boot +``` + +#### 💡 Tips +Commands must be run from /data/local/tmp unless you move pmt elsewhere.\ +The /data/local/tmp folder is cleared when you reboot your device.\ +Static builds are completely standalone — no missing library issues. diff --git a/README.md b/README.md index 6b81824..b54f16b 100755 --- a/README.md +++ b/README.md @@ -25,6 +25,8 @@ PMT is designed for developers, technicians, and Android enthusiasts who need fi ## Documentation +Read [INSTALLING.md](./INSTALLING.md) for learn installing to termux.\ +Read [USAGE.md - Using PMT via ADB](./INSTALLING.md#using-pmt-via-adb) for learn how to use PMT with ADB.\ Detailed usage instructions and option references can be found in the [USAGE.md](./USAGE.md) file. --- diff --git a/USAGE.md b/USAGE.md index 3b2d2ad..73470cf 100644 --- a/USAGE.md +++ b/USAGE.md @@ -242,89 +242,6 @@ This rule applies to **all commands except `reboot`**, since `reboot` only takes --- -## Using `pmt-static` via ADB - -This guide will show you how to use the **static** version of Partition Manager Tool (`pmt-static`) on your Android device through **ADB**. -It’s written for beginners — no advanced knowledge needed. - ---- - -## 📦 Why Static Version? -The **static** build of PMT contains everything it needs inside one single file. -This means you can run it directly on your Android device **without** installing extra libraries. -Perfect for quick tasks via ADB. - ---- - -## 📋 Requirements -- **ADB installed** on your computer - (Part of the Android SDK Platform Tools — [Download here](https://developer.android.com/studio/releases/platform-tools)) -- **USB Debugging enabled** on your phone - (Settings → Developer options → Enable USB debugging) -- Your **phone connected via USB** and recognized by ADB - ---- - -## 🚀 Step-by-Step Usage - -### 1️⃣ Get the Correct Binary -Download the **`pmt-static`** file that matches your device’s architecture: -- **`pmt-static-arm64-v8a`** → For 64-bit devices -- **`pmt-static-armeabi-v7a`** → For 32-bit devices - -Unzip the downloaded `.zip` file — you should now have a `pmt` binary. - ---- - -### 2️⃣ Push the Binary to Your Device -Use ADB to copy the `pmt` file to your phone’s temporary folder: -```bash -# Rename for more easily usage -mv pmt_static pmt - -adb push pmt /data/local/tmp/pmt -``` - -### 3️⃣ Open an ADB Shell -Access your device shell: -```bash -adb shell -``` - -### 4️⃣ Change to the Directory -Move into the temporary directory where pmt is stored: -```bash -cd /data/local/tmp -``` - -### 5️⃣ Give Execute Permission -Allow the binary to be executed: -```bash -chmod 755 pmt -``` - -### 6️⃣ Run PMT -You can now run PMT directly from this directory: - -```bash -# Open root terminal -su - -./pmt --help -``` -Example — Back up the boot partition: - -```bash -./pmt backup boot -``` - -### 💡 Tips -Commands must be run from /data/local/tmp unless you move pmt elsewhere.\ -The /data/local/tmp folder is cleared when you reboot your device.\ -Static builds are completely standalone — no missing library issues. - ---- - ## License Partition Manager Tool is licensed under the **Apache 2.0 License**. Copyright © YZBruh.