/mov-cli-subtitles

Watch everything from your terminal.

Primary LanguagePythonMIT LicenseMIT

Stargazers Pypi Version Python Versions Issues MIT License Discord

Logo

Watch everything from your terminal.

Report Bug · Request Feature


Note

v4 is constantly changing so be sure to keep the tool up to date and with that said I would advise not using it as a library yet.

Also we now have a discord:

Discord

Installation 🛠️

Prerequisites

  • A supported platform:
    • Linux
    • Windows
    • Android (via Termux)
    • iOS (via iSH Shell)
    • MacOS (Not tested)
  • fzf (optional)
  • python (required, with pip)
  • mpv (recommended & default media player)
  • lxml (optional, ⚡ faster scraping)

To get running these are all the prerequisites you'll need.

With the prerequisites installed, mov-cli can be installed via the pip command on all platforms with Python version 3.8 or above.

pip install mov-cli -U

Usage 🖱️

mov-cli comes packaged with a CLI interface via the mov-cli command you can use in your respective terminal.

Note

You may notice mov-cli doesn't ship with any scrapers (or previously known as providers) by default, this is because v4 is plugin-based and scrapers are now part of plugins that must be chosen to be installed. Find out how to do so at the wiki.

  1. Install the scraper plugin of your choice. Visit this wiki page on how to do so and the mov-cli-plugin topic for a list of third-party mov-cli plugins.
mov-cli -e
[mov-cli.plugins]
films = "package_name"
  1. Scraper away!
mov-cli -s films spider-man no way home

The above command should search for spider man no way home with the following scraper.

Tip

For in-depth instructions hit the wiki: https://github.com/mov-cli/mov-cli/wiki

Contributing ✨

Pull requests are welcome and appreciated. For major changes, please open an issue first to discuss what you would like to change.

Inspiration 🌟

Inspired by ani-cli, lobster and animdl