Sandroid Documentation

Sandroid Logo

Sandroid is a comprehensive Android forensic analysis framework designed for extracting artifacts from Android Virtual Devices (AVD). It provides both static and dynamic analysis capabilities for Android applications, including automated malware trigger execution, file system monitoring, network traffic capture, and comprehensive forensic reporting.

Features

🔍 Dynamic Analysis
  • Real-time file system monitoring

  • Network traffic capture and analysis

  • Process and socket monitoring

  • Frida-based runtime instrumentation

📱 Android Integration
  • ADB interface for device communication

  • Android emulator management

  • APK installation and analysis

  • Automated screenshot capture

🛡️ Security Analysis
  • Malware behavior monitoring

  • SSL/TLS traffic interception (friTap, mitmproxy with device/app proxies and CA injection)

  • Frida bypass suite for SSL pinning / root / Frida / debug / integrity checks (experimental)

  • Memory dumping capabilities

  • Automated trigger execution (TrigDroid)

🤖 AI Chat (experimental)
  • Chat assistant driving Sandroid tools via any OpenAI-compatible endpoint (prefer a local one such as Ollama – device data is sent to it)

📊 Reporting
  • JSON output format

  • PDF report generation

  • Persistent run history (run bundles)

  • Comprehensive logging

Quick Start

Installation:

pip install sandroid

Initialize Configuration:

sandroid-config init

Run Analysis:

# Interactive mode
sandroid

# Command-line mode
sandroid --network --screenshot 5 --report

Getting Started

API Reference

Advanced Topics

Developer Documentation

Note

For Contributors: Before contributing to Sandroid, please review the comprehensive Coding Guidelines that cover code style, testing requirements, security practices, and Sandroid-specific development patterns.

About

Indices and tables