Troubleshooting

# Manual download (Linux example)
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
unzip platform-tools-latest-linux.zip -d adb/

# Verify
./adb/platform-tools/adb version

# List devices
adb devices

# Use specific device
adb -s <serial> shell

# Option 1: Use ADB pull (tool does this automatically)
adb pull /sdcard/WhatsApp/Databases/msgstore.db.crypt14 .

# Option 2: If root access available
adb shell
su
cp /data/data/com.whatsapp/databases/msgstore.db /sdcard/
chmod 644 /sdcard/msgstore.db
exit
adb pull /sdcard/msgstore.db

# Use ADB directly with verbose logging
adb -s <device_serial> pull /sdcard/WhatsApp/Media ./backups/media/

# For very large folders, use rsync (Linux/macOS)
adb shell "cd /sdcard/WhatsApp && tar -czf - Media/" | tar -xzf - -C ./backups/

# Re-download backup from device
adb pull /sdcard/WhatsApp/Databases/msgstore.db.crypt14 ./msgstore.db.crypt14

# Verify file integrity (compare sizes)
adb shell ls -l /sdcard/WhatsApp/Databases/msgstore.db.crypt14
ls -l ./msgstore.db.crypt14
# Sizes should match exactly

# Calculate SHA-256 hash
# On device:
adb shell sha256sum /sdcard/WhatsApp/Databases/msgstore.db.crypt14
# On computer:
sha256sum ./msgstore.db.crypt14  # Linux/macOS
certutil -hashfile msgstore.db.crypt14 SHA256  # Windows

for iv_s in range(0, 190):
    if iv_s % 20 == 0:  # Progress every 20 iterations
        print(f"Scanning offset {iv_s}/190...")

# Ensure dependencies are installed
pip install -r requirements.txt

# Or manually install key packages
pip install pycryptodome rich colorama requests thefuzz tqdm

# Verify installation
python -c "from Crypto.Cipher import AES; print('OK')"

# Create venv
python -m venv venv

# Activate
# Windows:
venv\Scripts\activate

# Linux/macOS:
source venv/bin/activate

# Verify (should show venv path)
which python  # Linux/macOS
where python  # Windows

# Install dependencies in venv
pip install -r requirements.txt

# Run tool
python main.py

# Check version
python --version

# If too old, use python3 explicitly
python3 --version
python3 main.py

# Or create venv with specific version
python3.9 -m venv venv

# Verify SQLite database integrity
sqlite3 msgstore.db.decrypted.db "PRAGMA integrity_check;"

# List tables
sqlite3 msgstore.db.decrypted.db ".tables"

# If no 'chat' table, check for legacy tables
sqlite3 msgstore.db.decrypted.db "SELECT name FROM sqlite_master WHERE type='table';"

# Manually check for messages
sqlite3 msgstore.db.decrypted.db "SELECT COUNT(*) FROM message;"

import logging
logging.basicConfig(level=logging.DEBUG)

logger = logging.getLogger(__name__)
logger.debug(f"Trying offset IV:{iv_s}, DB:{db_s}")

from core.utils import logger

logger.info("Starting decryption...")
logger.debug(f"Key: {key_hex[:8]}...")

# Linux/macOS
tail -f app.log

# Windows PowerShell
Get-Content -Path app.log -Wait

# System info
python --version
adb version

# Tool version (check main.py header)
head -n 10 main.py

# Error messages (from app.log)
tail -n 50 app.log

# Device info
adb devices -l
adb shell getprop ro.build.version.release