Skip to content

Installation

Before proceeding, please note that MVT requires Python 3.6+ to run. While it should be available on most operating systems, please make sure of that before proceeding.

Dependencies on Linux

First install some basic dependencies that will be necessary to build all required tools:

sudo apt install python3 python3-pip libusb-1.0-0 sqlite3

libusb-1.0-0 is not required if you intend to only use mvt-ios and not mvt-android.

When working with Android devices you should additionally install Android SDK Platform Tools. If you prefer to install a package made available by your distribution of choice, please make sure the version is recent to ensure compatibility with modern Android devices.

Dependencies on macOS

Running MVT on macOS requires Xcode and homebrew to be installed.

In order to install dependencies use:

brew install python3 libusb sqlite3

libusb is not required if you intend to only use mvt-ios and not mvt-android.

When working with Android devices you should additionally install Android SDK Platform Tools:

brew install --cask android-platform-tools

Or by downloading the official binary releases.

MVT on Windows

MVT does not currently officially support running natively on Windows. While most functionality should work out of the box, there are known issues especially with mvt-android.

It is recommended to try installing and running MVT from Windows Subsystem Linux (WSL) and follow Linux installation instructions for your distribution of choice.

Installing MVT

If you haven't done so, you can add this to your .bashrc or .zshrc file in order to add locally installed PyPI binaries to your $PATH:

export PATH=$PATH:~/.local/bin

Then you can install MVT directly from PyPI

pip3 install mvt

If you want to have the latest features in development, you can install MVT directly from the source code. If you installed MVT previously from pypi, you should first uninstall it using pip3 uninstall mvt and then install from the source code:

git clone https://github.com/mvt-project/mvt.git
cd mvt
pip3 install .

You now should have the mvt-ios and mvt-android utilities installed.