Automate kali linux installation on huawei mate x3

QUICK_START.md

@@ -0,0 +1,125 @@
+# 🚀 Quick Start Guide - Kali Linux on Huawei Mate X3
+
+## One-Command Installation
+
+```bash
+# Download and run the installation script
+wget https://raw.githubusercontent.com/your-repo/kali-mate-x3/main/install_kali_x3.sh && chmod +x install_kali_x3.sh && ./install_kali_x3.sh
+```
+
+## Step-by-Step (Recommended)
+
+### 1. Prepare Termux
+```bash
+# Update Termux
+pkg update && pkg upgrade -y
+
+# Install git
+pkg install git -y
+
+# Grant storage access
+termux-setup-storage
+```
+
+### 2. Download Script
+```bash
+# Option A: Clone repository
+git clone https://github.com/your-repo/kali-mate-x3.git
+cd kali-mate-x3
+
+# Option B: Direct download
+wget https://raw.githubusercontent.com/your-repo/kali-mate-x3/main/install_kali_x3.sh
+```
+
+### 3. Install Kali Linux
+```bash
+# Make executable and run
+chmod +x install_kali_x3.sh
+./install_kali_x3.sh
+```
+
+### 4. Start Kali Linux
+```bash
+# After installation completes
+./start-kali.sh
+```
+
+## What the Script Does
+
+1. ✅ **Checks Prerequisites** - Verifies Termux environment and storage space
+2. ✅ **Updates Termux** - Ensures latest packages
+3. ✅ **Installs Dependencies** - Downloads required tools (wget, tar, proot, etc.)
+4. ✅ **Creates Directory Structure** - Sets up `/data/data/com.termux/files/home/KALI_ON_X3`
+5. ✅ **Downloads Kali Rootfs** - Gets latest ARM64 minimal rootfs (~1.5GB)
+6. ✅ **Extracts System** - Unpacks Kali Linux filesystem
+7. ✅ **Configures Environment** - Sets up DNS, hosts, profiles
+8. ✅ **Creates Scripts** - Generates startup and uninstall scripts
+9. ✅ **Updates Packages** - Ensures Kali packages are current
+
+## Installation Time
+- **Fast Internet**: ~15 minutes
+- **Slow Internet**: ~30 minutes
+- **Storage Used**: ~3-4GB
+
+## After Installation
+
+### Start Kali
+```bash
+./start-kali.sh
+```
+
+### Update Kali (First Time)
+```bash
+apt update && apt full-upgrade -y
+```
+
+### Install Tools
+```bash
+# Popular tools
+apt install nmap sqlmap burpsuite-community -y
+
+# Tool collections
+apt install kali-tools-top10 -y
+```
+
+### Exit Kali
+```bash
+exit
+```
+
+## Troubleshooting
+
+### Not Enough Space?
+```bash
+# Check space
+df -h
+
+# Clean Termux
+pkg clean && pkg autoremove
+```
+
+### Download Failed?
+```bash
+# Check internet connection
+ping google.com
+
+# Try different mirror
+# Edit script and change KALI_ROOTFS_URL
+```
+
+### Permission Denied?
+```bash
+# Make sure script is executable
+chmod +x install_kali_x3.sh
+
+# Check Termux permissions
+termux-setup-storage
+```
+
+## Need Help?
+- Check `~/kali_install.log` for detailed logs
+- Read the full README.md for comprehensive guide
+- Report issues with log file contents
+
+---
+**Ready to hack? Let's go! 🔐**