mvt README

The project's README from github.com/mvt-project/mvt. As one markdown file: README.md.

Mobile Verification Toolkit

[!IMPORTANT] We recently merged the "v3" branch. This introduced breaking changes. If you relied on mvt output in other scripts They might have broken. More details: https://github.com/mvt-project/mvt/issues/757

Documentation Status CI Downloads

Mobile Verification Toolkit (MVT) is a collection of utilities to simplify and automate the process of gathering forensic traces helpful to identify a potential compromise of Android and iOS devices.

It has been developed and released by the Amnesty International Security Lab in July 2021 in the context of the Pegasus Project along with a technical forensic methodology. It continues to be maintained by Amnesty International and other contributors.

Note MVT is a forensic research tool intended for technologists and investigators. It requires understanding digital forensics and using command-line tools. This is not intended for end-user self-assessment. If you are concerned with the security of your device please seek reputable expert assistance.

Indicators of Compromise

MVT supports using public indicators of compromise (IOCs) to scan mobile devices for potential traces of targeting or infection by known spyware campaigns. This includes IOCs published by Amnesty International and other research groups.

Warning Public indicators of compromise are insufficient to determine that a device is "clean", and not targeted with a particular spyware tool. Reliance on public indicators alone can miss recent forensic traces and give a false sense of security.

Reliable and comprehensive digital forensic support and triage requires access to non-public indicators, research and threat intelligence.

Such support is available to civil society through Amnesty International's Security Lab or through our forensic partnership with Access Now’s Digital Security Helpline.

More information about using indicators of compromise with MVT is available in the documentation.

Installation

MVT can be installed from sources or from PyPI (you will need some dependencies, check the documentation):

pip3 install mvt

You can also install MVT from PyPI with uv. First, install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then install MVT as a command-line tool:

uv tool install mvt

For alternative installation options and known issues, please refer to the documentation as well as GitHub Issues.

Usage

MVT provides three commands: mvt-ios and mvt-android analyse acquisitions from devices of that platform, and mvt hosts what belongs to neither: version, completion, plugins and download-iocs (version and download-iocs remain available on the platform commands for now). Running mvt on its own shows the installed version, update notices and the available commands. Check out the documentation to learn how to use them!

Pass --verbose to any of the three commands, before the command name (mvt-ios --verbose check-backup ...), for debug output. The --verbose option the check-* commands accept after their name still works but is kept for compatibility only and will be removed in a future release.

Shell completion

MVT can generate a shell completion script for Bash, Zsh, and Fish which covers mvt, mvt-ios and mvt-android:

mvt completion

The command prints setup instructions by default. To generate the completion script directly, pass the shell name:

mvt completion bash

MVT only writes completion files or shell configuration when --install is passed. See the command completion documentation for details.

Plugin packages extend MVT with additional forensic modules, which run inside the check-* commands, and with top-level commands on mvt, mvt-ios and mvt-android. See the development documentation for writing and installing them, and the custom CLI command documentation for the entry points a package registers commands in.

License

The purpose of MVT is to facilitate the consensual forensic analysis of devices of those who might be targets of sophisticated mobile spyware attacks, especially members of civil society and marginalized communities. We do not want MVT to enable privacy violations of non-consenting individuals. In order to achieve this, MVT is released under its own license. Read more here.

mvt (mvt-project/mvt)

Searching Database…

15.4K ·GitHub
Mvt
Что это такое?MVT (Mobile Verification Toolkit) — это набор криминалистических утилит, которые помогают собирать и анализировать следы на устройствах Android и iOS, чтобы выявить возможное заражение. Изначально его создала Security Lab организации Amnesty International в рамках Pegasus Project.
Это то, что я запускаю сам, или сервис, который сканирует мой телефон за меня?Это инструмент командной строки, который вы устанавливаете и запускаете на своём компьютере для копии данных устройства (резервной копии или извлечения). Удалённого сервиса сканирования нет.
Как его установить и запустить?Установите MVT из PyPI (в документации рекомендуется использовать uv) или из исходного кода, затем используйте команды mvt-ios, mvt-android или mvt в зависимости от платформы.
Могу ли я с его помощью проверить, безопасен ли мой собственный телефон?Не совсем. MVT — это исследовательский инструмент для криминалистики, предназначенный для специалистов и следователей, которые понимают цифровую криминалистику и работают с командной строкой, а не для самостоятельной проверки конечными пользователями. Если вы беспокоитесь за своё устройство, README советует обратиться за помощью к экспертам.
Работает ли он и на Android, и на iOS?Да, есть отдельные команды mvt-android и mvt-ios, каждая из которых анализирует копии данных устройств именно своей платформы.
Чем примечательна лицензия MVT?MVT распространяется по собственной лицензии, а не по стандартной открытой. Она специально разрешает криминалистический анализ с согласия владельца устройства и при этом стремится не допустить использования инструмента для нарушения приватности людей, которые не давали согласия.
Что такое Pegasus Project, из которого появился MVT?Pegasus Project — это расследование 2021 года о шпионском ПО Pegasus от NSO Group. В ходе него Security Lab организации Amnesty International выпустила MVT вместе с методикой криминалистического обнаружения таких заражений.
Откуда берутся индикаторы компрометации MVT и достаточно ли их?MVT может проверять устройство по публичным индикаторам компрометации (IOC), которые публикуют Amnesty International и другие исследовательские группы. Однако одних публичных IOC недостаточно, чтобы доказать, что устройство чистое: они могут пропустить недавние следы, поэтому полноценная проверка требует непубличных индикаторов и поддержки в виде данных о киберугрозах.
Можно ли дополнить MVT собственными проверками?Да, пакеты плагинов могут добавлять дополнительные криминалистические модули, которые работают внутри команд check- и регистрируют новые команды верхнего уровня для mvt, mvt-ios и mvt-android.
Поддерживает ли MVT автодополнение в оболочке?Да, он может генерировать скрипты автодополнения для Bash, Zsh и Fish, которые охватывают команды mvt, mvt-ios и mvt-android.
What are similar projects?Anthropic-Cybersecurity-Skills, wazuh, vol-rs, flowsint, awesome-honeypots, Mobile-Security-Framework-MobSF, radare2, Fieldwatch
Which topics is it in?investigation, surveillance, mobile-security, incident-response, threat-intelligence, forensics, malware-analysis, backup, security-tools, mobile, ios, android
Creator
mvt-project
Size
4.5 MB
Stars
15.4K
Updated
CommitOct 09Releasev2026.10.12Oct 12
Age
5y
Commits · 90 Days