mirror of
https://github.com/mvt-project/mvt.git
synced 2024-07-01 00:19:02 +00:00
66 lines
2.3 KiB
Markdown
66 lines
2.3 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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](https://developer.android.com/studio/releases/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](https://brew.sh) to be installed.
|
|
|
|
In order to install dependencies use:
|
|
|
|
```bash
|
|
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](https://developer.android.com/studio/releases/platform-tools):
|
|
|
|
```bash
|
|
brew install --cask android-platform-tools
|
|
```
|
|
|
|
Or by downloading the [official binary releases](https://developer.android.com/studio/releases/platform-tools).
|
|
|
|
## 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)](https://docs.microsoft.com/en-us/windows/wsl/about) 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`:
|
|
|
|
```bash
|
|
export PATH=$PATH:~/.local/bin
|
|
```
|
|
|
|
Then you can install MVT directly from [pypi](https://pypi.org/project/mvt/)
|
|
|
|
```bash
|
|
pip3 install mvt
|
|
```
|
|
|
|
Or from the source code:
|
|
|
|
```bash
|
|
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.
|