DeviceManager

Overview

The DeviceManager class (core/device_manager.py:13) handles all ADB operations including device detection, file extraction, and backup dumping from Android devices.

Class Definition

core/device_manager.py

class DeviceManager:
    """
    Consolidated class for ADB management, Device Scanning, and File Dumping.
    Replaces AdbManager, Scanner, and Dumper.
    """
    
    ADB_URLS = {
        'windows': 'https://dl.google.com/android/repository/platform-tools-latest-windows.zip',
        'linux': 'https://dl.google.com/android/repository/platform-tools-latest-linux.zip',
        'darwin': 'https://dl.google.com/android/repository/platform-tools-latest-darwin.zip'
    }
    
    WHATSAPP_PACKAGES = {
        'com.whatsapp': 'WhatsApp Messenger',
        'com.whatsapp.w4b': 'WhatsApp Business'
    }

Constructor

`init()`

def __init__(self, adb_dir: str = "adb", output_dir: str = "backups")

adb_dir

str

default:"adb"

Directory where ADB binaries are stored/downloaded

output_dir

str

default:"backups"

Directory where extracted backups will be saved

Attributes:

adb_dir: Absolute path to ADB directory
output_dir: Output directory for backups
os_type: Detected OS (windows, linux, darwin)
adb_executable: Path to adb executable

ADB Management

`is_installed()`

Checks if ADB is installed and accessible.

def is_installed(self) -> bool

return

bool

True if ADB executable exists and is accessible

`download_adb()`

Automatically downloads platform-specific ADB binaries.

def download_adb(self)

Process:

Detects operating system
Downloads from ADB_URLS[os_type]
Extracts to adb_dir
Sets executable permissions (Unix)
Updates adb_executable path

`run_command()`

Executes an ADB command and returns the result.

def run_command(self, args: List[str]) -> Tuple[int, str, str]

args

List[str]

required

List of ADB command arguments (e.g., [‘devices’], [‘-s’, ‘serial’, ‘shell’, ‘ls’])

return

Tuple[int, str, str]

(return_code, stdout, stderr)

Example:

device_mgr = DeviceManager()
code, output, error = device_mgr.run_command(['devices'])
if code == 0:
    print(output)

Device Discovery

`get_devices()`

Returns a list of connected Android devices.

def get_devices(self) -> List[str]

return

List[str]

List of device serial numbers

Example:

devices = device_mgr.get_devices()
for serial in devices:
    print(f"Found device: {serial}")

`get_detailed_device_info()`

Retrieves comprehensive device information.

def get_detailed_device_info(self, serial: str) -> dict

serial

str

required

Device serial number

return

dict

Dictionary containing device properties:

Model, Brand, Manufacturer, Device, Board
Android Version, SDK, Security Patch
Battery level, RAM (Total/Available)
Storage (Total/Used/Free)
WhatsApp Installations

Example:

info = device_mgr.get_detailed_device_info("RF8N70PQRST")
print(f"Model: {info['Model']}")
print(f"Android: {info['Android Version']}")
print(f"Battery: {info['Battery']}")

`get_users()`

Retrieves user profiles from the device.

def get_users(self, device_id: str) -> List[Dict[str, str]]

device_id

str

required

Device serial number

return

List[Dict[str, str]]

List of user dictionaries with ‘id’ and ‘name’ keys

Example:

users = device_mgr.get_users("RF8N70PQRST")
for user in users:
    print(f"User {user['id']}: {user['name']}")

`check_packages()`

Checks which WhatsApp packages are installed.

def check_packages(self, device_id: str) -> List[str]

device_id

str

required

Device serial number

return

List[str]

List of installed package names (com.whatsapp, com.whatsapp.w4b)

Backup Discovery

`find_backups()`

Scans device storage for WhatsApp backup files.

def find_backups(self, device_id: str, user_id: str, package: str) -> List[Dict[str, str]]

device_id

str

required

Device serial number

user_id

str

required

User profile ID (usually “0” for primary user)

package

str

required

Package name (com.whatsapp or com.whatsapp.w4b)

return

List[Dict[str, str]]

List of backup dictionaries containing:

path: Full device path to backup file
name: Filename (e.g., msgstore.db.crypt15)
size: Human-readable file size

Search Paths:

Legacy: /sdcard/WhatsApp/Databases
Android 11+: /sdcard/Android/media/com.whatsapp/WhatsApp/Databases

`find_media()`

Locates WhatsApp Media folder on device.

def find_media(self, device_id: str, user_id: str, package: str) -> str

device_id

str

required

Device serial number

user_id

str

required

User profile ID

package

str

required

Package name

return

str

Path to Media folder, or empty string if not found

File Operations

`dump_backup()`

Pulls a backup file from device to local storage.

def dump_backup(
    self, 
    device_id: str, 
    remote_path: str, 
    user_id: str, 
    package_type: str, 
    verbose: bool = True
) -> str

device_id

str

required

Device serial number

remote_path

str

required

Full path to backup file on device

user_id

str

required

User profile ID

package_type

str

required

“messenger” or “business”

verbose

bool

default:"True"

Print status messages

return

str

Local path to dumped file, or empty string on failure

Output Structure:

backups/
  {device_id}/
    user_{user_id}/
      {package_type}/
        msgstore.db.crypt15

`dump_media_with_progress()`

Pulls entire Media folder with progress tracking.

def dump_media_with_progress(
    self, 
    device_id: str, 
    remote_path: str, 
    local_dir: str
) -> bool

device_id

str

required

Device serial number

remote_path

str

required

Path to Media folder on device

local_dir

str

required

Local directory to save media files

return

bool

True if successful, False otherwise

Features:

Counts total files before transfer
Shows progress bar with tqdm
Preserves directory structure
Handles large media collections

Constants

`ADB_URLS`

Download URLs for platform-specific ADB binaries.

ADB_URLS = {
    'windows': 'https://dl.google.com/android/repository/platform-tools-latest-windows.zip',
    'linux': 'https://dl.google.com/android/repository/platform-tools-latest-linux.zip',
    'darwin': 'https://dl.google.com/android/repository/platform-tools-latest-darwin.zip'
}

`WHATSAPP_PACKAGES`

Supported WhatsApp package identifiers.

WHATSAPP_PACKAGES = {
    'com.whatsapp': 'WhatsApp Messenger',
    'com.whatsapp.w4b': 'WhatsApp Business'
}

Usage Example

from core.device_manager import DeviceManager

# Initialize manager
device_mgr = DeviceManager()

# Ensure ADB is available
if not device_mgr.is_installed():
    print("Downloading ADB...")
    device_mgr.download_adb()

# Get connected devices
devices = device_mgr.get_devices()
if not devices:
    print("No devices found")
    exit(1)

serial = devices[0]
print(f"Using device: {serial}")

# Get device info
info = device_mgr.get_detailed_device_info(serial)
print(f"Model: {info['Model']}")
print(f"Android: {info['Android Version']}")

# Find backups
users = device_mgr.get_users(serial)
packages = device_mgr.check_packages(serial)

for user in users:
    for pkg in packages:
        backups = device_mgr.find_backups(serial, user['id'], pkg)
        for backup in backups:
            print(f"Found: {backup['name']} ({backup['size']})")
            
            # Dump backup
            pkg_type = "messenger" if pkg == "com.whatsapp" else "business"
            local_path = device_mgr.dump_backup(
                serial,
                backup['path'],
                user['id'],
                pkg_type
            )
            print(f"Saved to: {local_path}")

Device Scanning

Learn about device detection and scanning

Backup Extraction

Extract backups from devices

ADB Operations

Advanced ADB usage and troubleshooting

Platform Guides

Platform-specific setup instructions

Core Modules

Overview

Class Definition

Constructor

`init()`

ADB Management

`is_installed()`

`download_adb()`

`run_command()`

Device Discovery

`get_devices()`

`get_detailed_device_info()`

`get_users()`

`check_packages()`

Backup Discovery

`find_backups()`

`find_media()`

File Operations

`dump_backup()`

`dump_media_with_progress()`

Constants

`ADB_URLS`

`WHATSAPP_PACKAGES`

Usage Example

Device Scanning

Backup Extraction

ADB Operations

Platform Guides

Build docs developers (and LLMs) love

Core Modules

​Overview

​Class Definition

​Constructor

​__init__()

​ADB Management

​is_installed()

​download_adb()

​run_command()

​Device Discovery

​get_devices()

​get_detailed_device_info()

​get_users()

​check_packages()

​Backup Discovery

​find_backups()

​find_media()

​File Operations

​dump_backup()

​dump_media_with_progress()

​Constants

​ADB_URLS

​WHATSAPP_PACKAGES

​Usage Example

​Related

Device Scanning

Backup Extraction

ADB Operations

Platform Guides

Build docs developers (and LLMs) love

Overview

Class Definition

Constructor

`init()`

ADB Management

`is_installed()`

`download_adb()`

`run_command()`

Device Discovery

`get_devices()`

`get_detailed_device_info()`

`get_users()`

`check_packages()`

Backup Discovery

`find_backups()`

`find_media()`

File Operations

`dump_backup()`

`dump_media_with_progress()`

Constants

`ADB_URLS`

`WHATSAPP_PACKAGES`

Usage Example

Related