Android/Termux Guide

# From main.py
IS_TERMUX = False
if os.environ.get("PREFIX") and "com.termux" in os.environ.get("PREFIX"):
    IS_TERMUX = True

if IS_TERMUX:
    from core.termux_manager import TermuxManager
    ui.update_status("mode", "Termux")
else:
    from core.device_manager import DeviceManager
    ui.update_status("mode", "ADB")

# Detect Termux environment
if [[ -n "$PREFIX" && "$PREFIX" == *"com.termux"* ]]; then
  echo "[*] Detected Termux environment"
  
  # Auto-move from Downloads if running there
  if [[ "$PWD" == *"/storage/emulated/0/Download"* ]]; then
    TARGET_DIR="$HOME/whatsapp-forensic-tool"
    mkdir -p "$TARGET_DIR"
    cp -r ./* "$TARGET_DIR/"
    echo "[*] Moved to ~/whatsapp-forensic-tool"
    exit 0
  fi
  
  # Setup storage access
  if [ ! -d "$HOME/storage" ]; then
    termux-setup-storage
  fi
  
  # Install Python if missing
  if ! command -v python &> /dev/null; then
    pkg update -y && pkg install -y python
  fi
  
  # Install dependencies and run
  pip install -r requirements.txt
  python main.py
fi

# From core/termux_manager.py
base_paths = [
    "/sdcard",
    os.path.join(home, "storage/shared"),
    os.path.join(home, "storage/external-1")
]

search_paths = [
    "WhatsApp/Databases",
    "Android/media/com.whatsapp/WhatsApp/Databases",
    "WhatsApp Business/Databases",
    "Android/media/com.whatsapp.w4b/WhatsApp Business/Databases"
]

cd ~/whatsapp-forensic-tool
bash start.sh

===========================================
  WhatsApp Backup Forensic Tool Launcher
===========================================
[*] Detected Termux environment
[*] Installing Python dependencies...
[*] Starting Application...

# From core/termux_manager.py
class TermuxManager:
    def __init__(self, output_dir: str = "backups"):
        self.output_dir = output_dir
        self.os_type = 'termux'
    
    def is_installed(self) -> bool:
        # ADB not needed in Termux
        return True
    
    def get_devices(self) -> List[str]:
        # Returns localhost
        return ["localhost (Termux)"]
    
    def find_backups(self, device_id, user_id, package):
        # Direct filesystem access
        # Searches /sdcard, ~/storage/shared, etc.
        ...
    
    def dump_backup(self, device_id, remote_path, ...):
        # Uses shutil.copy2 instead of adb pull
        shutil.copy2(remote_path, local_path)

# Run setup again
termux-setup-storage

# Manually grant in Android Settings:
# Settings → Apps → Termux → Permissions → Storage → Allow

# Update package lists
pkg update && pkg upgrade -y

# Try installing again
pkg install python

# If still fails, clear cache
pkg clean
pkg update
pkg install python

# Check Termux storage usage
du -sh ~/*

# Clean package cache
pkg clean
apt clean

# Move backups to SD card
mv ~/whatsapp-forensic-tool/backups ~/storage/shared/WhatsApp-Backups

# Update ca-certificates
pkg install ca-certificates

# Upgrade pip
pip install --upgrade pip

# Retry installation
pip install -r requirements.txt

# Verify Termux environment variable
echo $PREFIX
# Should output: /data/data/com.termux/files/usr

# If empty, restart Termux app completely
# Don't use "adb shell" - use Termux app UI

# Install tmux for persistent sessions
pkg install tmux

# Start tmux session
tmux new -s forensic

# Run tool
cd ~/whatsapp-forensic-tool
python main.py

# Detach: Ctrl+B, then D
# Reattach: tmux attach -t forensic

#!/bin/bash
# save as ~/auto-backup.sh

SOURCE="/sdcard/WhatsApp/Databases"
DEST="$HOME/whatsapp-forensic-tool/backups/manual"

mkdir -p "$DEST"
cp -v "$SOURCE"/msgstore*.crypt* "$DEST/"
echo "Backup copied: $(date)"

chmod +x ~/auto-backup.sh
bash ~/auto-backup.sh

# Install tsu (Termux su wrapper)
pkg install tsu

# Access root shell
sudo su

# Navigate to app data
cd /data/data/com.whatsapp/files

# Copy encryption key
cp key ~/whatsapp-forensic-tool/

# Exit root
exit

# SQLite browser
pkg install sqlite

# File manager
pkg install nnn

# Text editor
pkg install vim nano

# Network tools
pkg install openssh rsync

# Compression tools
pkg install zip unzip