# mvt-project/mvt architecture

> Architecture diagram of the GitHub repository mvt-project/mvt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mvt-project/mvt
- Repository: https://github.com/mvt-project/mvt
- Video tour (about a minute): https://gitdiagram.com/mvt-project/mvt/video

## Overview

MVT is a command-line mobile forensics toolkit: investigators analyze Android or iOS acquisitions, whose platform-specific modules extract forensic traces and check them against IOC collections, producing findings and alerts. The repository also supports plugins that add forensic modules and CLI commands. The graph shows the documented acquisition-to-analysis workflow and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled module internals and some result-writing paths are not inferred.

Main entry points: [`src/mvt/ios/cmd_check_backup.py`](https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/cmd_check_backup.py) (iOS Checks), [`src/mvt/android/cli.py`](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cli.py) (Android CLI), [`src/mvt/common/command.py`](https://github.com/mvt-project/mvt/blob/main/src/mvt/common/command.py) (Command Runtime), [`src/mvt/android/cmd_check_backup.py`](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_backup.py) (Backup Check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_common["Shared Runtime"]
  node_command["Command Runtime<br/>[command.py]"]
  node_module["Module Framework<br/>[module.py]"]
  node_indicators["IOC Processing<br/>[indicators.py]"]
  node_alerts["Findings And Alerts<br/>[alerts.py]"]
end

subgraph group_android["Android Analysis"]
  node_android_cli["Android CLI<br/>[cli.py]"]
  node_android_checks["Android Checks"]
  node_android_backup["Backup Check"]
  node_android_aqf["AndroidQF Check"]
  node_intrusion_check["Intrusion Logs"]
  node_android_modules["Android Modules"]
  node_aqf_modules["AndroidQF Modules<br/>[base.py]"]
  node_backup_modules["Android Backup Modules<br/>[base.py]"]
  node_backup_parser["Backup Parser<br/>[backup.py]"]
  node_intrusion_modules["Log Modules<br/>[base.py]"]
end

subgraph group_ios["iOS Analysis"]
  node_ios_cli["iOS CLI<br/>[cli.py]"]
  node_ios_checks["iOS Checks"]
  node_ios_backup["iOS Backup Modules<br/>[manifest.py]"]
  node_ios_fs["Filesystem Modules"]
  node_ios_mixed["Artifact Modules"]
  node_ios_sysdiagnose["Sysdiagnose Modules<br/>[base.py]"]
  node_ios_decrypt["Backup Decryption<br/>[decrypt.py]"]
end

subgraph group_extensions["Extensions"]
  node_plugin_loading["Plugin Loading<br/>[module_loader.py]"]
  node_cli_plugins["CLI Plugins<br/>[cli_plugins.py]"]
end

node_investigator(("Investigator"))
node_acquisition["Device Acquisition"]

node_investigator -->|"runs"| node_android_cli
node_investigator -->|"runs"| node_ios_cli
node_acquisition -->|"analyzed by"| node_android_checks
node_acquisition -->|"analyzed by"| node_ios_checks
node_android_cli -->|"dispatches"| node_android_checks
node_android_cli -->|"dispatches"| node_android_backup
node_android_cli -->|"dispatches"| node_android_aqf
node_android_cli -->|"dispatches"| node_intrusion_check
node_ios_cli -->|"dispatches"| node_ios_checks
node_android_checks -->|"runs"| node_command
node_android_backup -->|"runs"| node_command
node_android_aqf -->|"runs"| node_command
node_intrusion_check -->|"runs"| node_command
node_ios_checks -->|"runs"| node_command
node_android_checks -->|"loads"| node_android_modules
node_android_backup -->|"loads"| node_backup_modules
node_android_backup -->|"parses with"| node_backup_parser
node_android_aqf -->|"loads"| node_aqf_modules
node_intrusion_check -->|"loads"| node_intrusion_modules
node_ios_checks -->|"loads"| node_ios_backup
node_ios_checks -->|"analyzes"| node_ios_fs
node_ios_checks -->|"analyzes"| node_ios_mixed
node_ios_checks -->|"analyzes"| node_ios_sysdiagnose
node_ios_checks -->|"decrypts with"| node_ios_decrypt
node_command -->|"orchestrates"| node_module
node_command -->|"uses"| node_indicators
node_module -->|"records"| node_alerts
node_android_cli -->|"loads modules"| node_plugin_loading
node_android_cli -->|"registers commands"| node_cli_plugins
node_ios_cli -->|"loads modules"| node_plugin_loading
node_ios_cli -->|"registers commands"| node_cli_plugins
node_plugin_loading -->|"extends"| node_module
node_indicators -.->|"matches findings"| node_alerts

click node_android_cli "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cli.py"
click node_ios_cli "https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/cli.py"
click node_android_checks "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_bugreport.py"
click node_android_backup "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_backup.py"
click node_android_aqf "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_androidqf.py"
click node_intrusion_check "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_intrusion_logs.py"
click node_android_modules "https://github.com/mvt-project/mvt/tree/main/src/mvt/android/modules/bugreport"
click node_aqf_modules "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/modules/androidqf/base.py"
click node_backup_modules "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/modules/backup/base.py"
click node_backup_parser "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/parsers/backup.py"
click node_intrusion_modules "https://github.com/mvt-project/mvt/blob/main/src/mvt/android/modules/intrusion_logs/base.py"
click node_ios_checks "https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/cmd_check_backup.py"
click node_ios_backup "https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/modules/backup/manifest.py"
click node_ios_fs "https://github.com/mvt-project/mvt/tree/main/src/mvt/ios/modules/fs"
click node_ios_mixed "https://github.com/mvt-project/mvt/tree/main/src/mvt/ios/modules/mixed"
click node_ios_sysdiagnose "https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/modules/sysdiagnose/base.py"
click node_ios_decrypt "https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/decrypt.py"
click node_command "https://github.com/mvt-project/mvt/blob/main/src/mvt/common/command.py"
click node_module "https://github.com/mvt-project/mvt/blob/main/src/mvt/common/module.py"
click node_indicators "https://github.com/mvt-project/mvt/blob/main/src/mvt/common/indicators.py"
click node_alerts "https://github.com/mvt-project/mvt/blob/main/src/mvt/common/alerts.py"
click node_plugin_loading "https://github.com/mvt-project/mvt/blob/main/src/mvt/common/module_loader.py"
click node_cli_plugins "https://github.com/mvt-project/mvt/blob/main/src/mvt/common/cli_plugins.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_command,node_module,node_indicators,node_alerts toneBlue
class node_android_cli,node_android_checks,node_android_backup,node_android_aqf,node_intrusion_check,node_android_modules,node_aqf_modules,node_backup_modules,node_backup_parser,node_intrusion_modules toneAmber
class node_ios_cli,node_ios_checks,node_ios_backup,node_ios_fs,node_ios_mixed,node_ios_sysdiagnose,node_ios_decrypt toneMint
class node_plugin_loading,node_cli_plugins toneRose
class node_investigator,node_acquisition toneIndigo
```

## Components

### Shared Runtime

- [Command Runtime](https://github.com/mvt-project/mvt/blob/main/src/mvt/common/command.py): `src/mvt/common/command.py`
- [Module Framework](https://github.com/mvt-project/mvt/blob/main/src/mvt/common/module.py): `src/mvt/common/module.py`
- [IOC Processing](https://github.com/mvt-project/mvt/blob/main/src/mvt/common/indicators.py): `src/mvt/common/indicators.py`
- [Findings And Alerts](https://github.com/mvt-project/mvt/blob/main/src/mvt/common/alerts.py): `src/mvt/common/alerts.py`

### Android Analysis

- [Android CLI](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cli.py): `src/mvt/android/cli.py`
- [Android Checks](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_bugreport.py): `src/mvt/android/cmd_check_bugreport.py`
- [Backup Check](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_backup.py): `src/mvt/android/cmd_check_backup.py`
- [AndroidQF Check](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_androidqf.py): `src/mvt/android/cmd_check_androidqf.py`
- [Intrusion Logs](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/cmd_check_intrusion_logs.py): `src/mvt/android/cmd_check_intrusion_logs.py`
- [Android Modules](https://github.com/mvt-project/mvt/tree/main/src/mvt/android/modules/bugreport): `src/mvt/android/modules/bugreport`
- [AndroidQF Modules](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/modules/androidqf/base.py): `src/mvt/android/modules/androidqf/base.py`
- [Android Backup Modules](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/modules/backup/base.py): `src/mvt/android/modules/backup/base.py`
- [Backup Parser](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/parsers/backup.py): `src/mvt/android/parsers/backup.py`
- [Log Modules](https://github.com/mvt-project/mvt/blob/main/src/mvt/android/modules/intrusion_logs/base.py): `src/mvt/android/modules/intrusion_logs/base.py`

### iOS Analysis

- [iOS CLI](https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/cli.py): `src/mvt/ios/cli.py`
- [iOS Checks](https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/cmd_check_backup.py): `src/mvt/ios/cmd_check_backup.py`
- [iOS Backup Modules](https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/modules/backup/manifest.py): `src/mvt/ios/modules/backup/manifest.py`
- [Filesystem Modules](https://github.com/mvt-project/mvt/tree/main/src/mvt/ios/modules/fs): `src/mvt/ios/modules/fs`
- [Artifact Modules](https://github.com/mvt-project/mvt/tree/main/src/mvt/ios/modules/mixed): `src/mvt/ios/modules/mixed`
- [Sysdiagnose Modules](https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/modules/sysdiagnose/base.py): `src/mvt/ios/modules/sysdiagnose/base.py`
- [Backup Decryption](https://github.com/mvt-project/mvt/blob/main/src/mvt/ios/decrypt.py): `src/mvt/ios/decrypt.py`

### Extensions

- [Plugin Loading](https://github.com/mvt-project/mvt/blob/main/src/mvt/common/module_loader.py): `src/mvt/common/module_loader.py`
- [CLI Plugins](https://github.com/mvt-project/mvt/blob/main/src/mvt/common/cli_plugins.py): `src/mvt/common/cli_plugins.py`

### Other components

- **Investigator**
- **Device Acquisition**

## Connections

- Investigator → Android CLI: runs
- Investigator → iOS CLI: runs
- Device Acquisition → Android Checks: analyzed by
- Device Acquisition → iOS Checks: analyzed by
- Android CLI → Android Checks: dispatches (evidence: `src/mvt/android/cli.py`)
- Android CLI → Backup Check: dispatches (evidence: `src/mvt/android/cli.py`)
- Android CLI → AndroidQF Check: dispatches (evidence: `src/mvt/android/cli.py`)
- Android CLI → Intrusion Logs: dispatches (evidence: `src/mvt/android/cli.py`)
- iOS CLI → iOS Checks: dispatches (evidence: `src/mvt/ios/cli.py`)
- Android Checks → Command Runtime: runs (evidence: `src/mvt/android/cmd_check_bugreport.py`)
- Backup Check → Command Runtime: runs (evidence: `src/mvt/android/cmd_check_backup.py`)
- AndroidQF Check → Command Runtime: runs (evidence: `src/mvt/android/cmd_check_androidqf.py`)
- Intrusion Logs → Command Runtime: runs (evidence: `src/mvt/android/cmd_check_intrusion_logs.py`)
- iOS Checks → Command Runtime: runs
- Android Checks → Android Modules: loads (evidence: `src/mvt/android/cmd_check_bugreport.py`)
- Backup Check → Android Backup Modules: loads (evidence: `src/mvt/android/cmd_check_backup.py`)
- Backup Check → Backup Parser: parses with (evidence: `src/mvt/android/cmd_check_backup.py`)
- AndroidQF Check → AndroidQF Modules: loads (evidence: `src/mvt/android/cmd_check_androidqf.py`)
- Intrusion Logs → Log Modules: loads (evidence: `src/mvt/android/cmd_check_intrusion_logs.py`)
- iOS Checks → iOS Backup Modules: loads
- iOS Checks → Filesystem Modules: analyzes
- iOS Checks → Artifact Modules: analyzes
- iOS Checks → Sysdiagnose Modules: analyzes
- iOS Checks → Backup Decryption: decrypts with (evidence: `src/mvt/ios/cli.py`)
- Command Runtime → Module Framework: orchestrates (evidence: `src/mvt/common/command.py`)
- Command Runtime → IOC Processing: uses (evidence: `src/mvt/common/command.py`)
- Module Framework → Findings And Alerts: records (evidence: `src/mvt/common/module.py`)
- Android CLI → Plugin Loading: loads modules (evidence: `src/mvt/android/cli.py`)
- Android CLI → CLI Plugins: registers commands (evidence: `src/mvt/android/cli.py`)
- iOS CLI → Plugin Loading: loads modules (evidence: `src/mvt/ios/cli.py`)
- iOS CLI → CLI Plugins: registers commands (evidence: `src/mvt/ios/cli.py`)
- Plugin Loading → Module Framework: extends (evidence: `src/mvt/common/module_loader.py`)
- IOC Processing → Findings And Alerts: matches findings
