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.
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.
Tip
For in-depth installation instructions hit the wiki.
- 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.
mov-cli.mp4
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.
- 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"
- Scrape away!
mov-cli -s youtube blender studio
![](https://private-user-images.githubusercontent.com/132799819/341441987-f7a75a14-105b-4afa-9075-bb2d937baa25.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTk1MzM4MTksIm5iZiI6MTcxOTUzMzUxOSwicGF0aCI6Ii8xMzI3OTk4MTkvMzQxNDQxOTg3LWY3YTc1YTE0LTEwNWItNGFmYS05MDc1LWJiMmQ5MzdiYWEyNS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwNjI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDYyOFQwMDExNTlaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1lNzcwNDIwZTgxYzQ4ZWU3ODM4NjA2YjFmYTMzZmQ1ZTMxNTk4YjQwZTg2NWYzNDQ0YTcwYTg1YWEwZDQyODJjJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.3rI7YJXEt3CvGqdQsfBzO7d9REOIZLnNHpgB1I_Hqpk)
The command above searches for
blender studio
with our youtube plugin, however once again mov-cli is plugin based and there are many of them in the wild. 😉
Pull requests are welcome and appreciated. For major changes, please open an issue first to discuss what you would like to change.