To install mov-cli on your system you require a few things, a python interpreter, a media player and the optional requirement fzf. These have been linked on the readme. The steps below will guide you step by step on installing these.

Third-party packages are available but they are third-party packages and some are currently experimental so if they break it's expected and we are not responsible unless it's our package (AUR package).

If you prefer a video tutorial, watch this YouTube guide.

1. Install the prerequisites.

Open your terminal and run the following commands:

scoop install git python
scoop bucket add extras
scoop install mpv fzf

2. Install mov-cli.

Use pip to install mov-cli:

pip install mov-cli -U

3. Then install a plugin of your choice.

Installing mov-cli v4 on Linux is quite simple but not as straightforward at the moment on all distros and we currently do not offer distro packages. I'm going to assume you know a bit about your system or particular distro.

1. Install the prerequisites.

sudo pacman -S fzf mpv

sudo apt install fzf mpv 

sudo dnf install fzf mpv

2. Install mov-cli.

Now this is where we hit a roadblock. You may notice that the command below will give you an error like error: externally-managed-environment or if you don't even have pip installed: pip: command not found.

pip install mov-cli -U

This is because many major Linux distros have switched to disabling pip following PEP 668 to save you from breaking your system. (simply put)

To fix this it's recommended to install a tool that can manage your python packages externally a such as pipx or poetry. We're gonna be using pipx in this tutorial.

1. Install pipx from your package manager.

sudo pacman -S python-pipx

sudo apt install pipx

sudo dnf install pipx

3. Then you'll be able to install mov-cli with pipx.

pipx install mov-cli

4. To install plugins use the inject sub command like so:

pipx inject mov-cli {package_name}

More on that over here.

Then that's all, have a nice day. 🌈

Installing mov-cli on Arch is very simple with the help of an AUR helper. We'll use yay for this example.

yay -S mov-cli

1. Install the prerequisites.

Open your terminal and run the following commands:

brew install python fzf pipx

2. Install mov-cli Use pipx to install mov-cli:

pipx install mov-cli

3. Choose and install a media player. iina is one media player you can use that has great support over many Macintosh devices and generally recommended by the community. It is mpv under the hood. However you may use vanilla mpv if you want.

brew install --cask iina

Then be sure to set iina as you default player.

mov-cli -e

[mov-cli]
player = "iina"

To use mpv, you may need to install it from macports. mov-cli should default to mpv so you won't need to tinker with the config.

4. Now find a plugin of your chose and install it with pipx using the inject sub command like so:

pipx inject mov-cli {package_name}

To begin, install Termux and mpv onto your Phone.

1. Once Termux is installed, open the app and enter the following commands.

pkg update
pkg install python fzf

2. Install mov-cli via pip.

pip install mov-cli -U

3. Then install a plugin of your choice.

• Repository is under maintenance or down.

  If you installed the Play Store version of Termux you may get an error similar to the one below.

  E: The repository 'https://dl.bintray.com/grimler/game-packages-24 games Release' does not have a Release file.
  N: Metadata integrity can't be verified, repository is disabled now.
  N: Possible cause: repository is under maintenance or down (wrong sources.list URL?).
  E: The repository 'https://dl.bintray.com/grimler/science-packages-24 science Release' does not have a Release file.
  N: Metadata integrity can't be verified, repository is disabled now.                             
  N: Possible cause: repository is under maintenance or down (wrong sources.list URL?).
  

  To fix this remove these two packages:

  pkg remove game-repo science-repo

  Then try the install commands again.

To begin, install iSH and VLC onto your iPhone.

1. Once iSH is installed, open the app and enter the following commands.

apk update && apk upgrade

apk add python3 py3-pip fzf

2. Install mov-cli via pip.

pip3 install mov-cli

3. Then install a plugin of your choice.

4. Then lastly set VLC as your default media player in the mov-cli config.

mov-cli -e

[mov-cli]
player = "vlc"