Skip to content

bachig26/mov-cli

 
 

Repository files navigation

Stargazers Pypi Version Pypi Downloads Python Versions Issues MIT License

Logo

Watch everything from your terminal.

Report Bug · Request Feature



Logo

Note

v4 is constantly changing so be sure to keep the tool and your plugins up to date. Also, I would advise not using it as a library yet as the API still has many breaking changes.

What is mov-cli? 💫

mov-cli is a command line tool with plugin support that streamlines the process of streaming media from the comfort of your terminal; so you can show off to your friends the superiority of the command line. 💪 The tool is sort of a framework that handles metadata, configuration and scraping of the media to be streamed in your media player of choice.

mov-cli is not a piracy tool; in fact, we encourage the opposite through the existence of our plugins mov-cli-fs and mov-cli-media-server. 🫵 You obtain the media. You pick the plugins.

Installation 🛠️

Tip

For in-depth installation instructions hit the wiki.

Prerequisites

  • A supported platform:
  • python (required, with pip)
  • lxml (optional, ⚡ faster scraping)
  • fzf (optional but highly recommended)
  • mpv (recommended & default media player)

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

Check out the wiki on installation for more in-depth guidance on installing mov-cli.

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

Alternatively, you may also edit by manually opening the config file. See this Wiki page on that.

[mov-cli.plugins]
youtube = "mov-cli-youtube"
  1. Scrape away!
mov-cli -s youtube flight 370

The command above searches for flight 370 with our youtube plugin, however once again mov-cli is plugin based and there are many of them in the wild. 😉

Star Graph ⭐

Star Graph Chart

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

About

Watch everything from your terminal.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 99.6%
  • Makefile 0.4%