Cinnamon | Beta
Watch TV shows, movies, and anime from your terminal. Search, pick a title, and it plays in mpv or VLC.
Quick start
You'll need Python 3.10+ and either mpv or VLC.
Install
pip install cinnamon-cli
cinnamon setup
The setup wizard asks for a TMDB API key (Create a free account here), the api key is used for show and movie information. If you skip it, it will use an experimental 2embed search (no key needed), it works but is less reliable.
Get a player
Please note that MacOS version has not been tested since we dont have access to a mac
| Platform | mpv | VLC |
|---|---|---|
| Windows | scoop install mpv or download from mpv.io |
videolan.org |
| macOS | brew install mpv |
brew install --cask vlc |
| Linux | apt install mpv (Debian/Ubuntu) |
apt install vlc |
| Termux | pkg install mpv |
pkg install vlc |
Watch a show or movie
cinnamon search "Breaking Bad"
cinnamon search "Inception"
For Anime you can run:
cinnamon anime "Chainsaw Man"
By default you'll be asked whether to watch sub or dub. Skip the prompt with
-sub / -dub:
cinnamon anime "Chainsaw Man" --sub
cinnamon anime "Frieren" --dub
you can also run it like this:
cinnamon Inception
cinnamon Breaking bad
cinnamon chainsaw man # Not reccomended to search an anime like this
Download episodes
Downloading needs yt-dlp.
pip install yt-dlp
Now you can run:
cinnamon search "Breaking Bad" -d -e 1-5
Commands
| If you run this… | …this happens |
|---|---|
cinnamon anime <query> |
Search anime via AniList (no API key needed) |
cinnamon search <query> |
Find a show, pick an episode, watch it |
cinnamon watch --id 123 -s 2 -e 5 |
Go straight to S2E5 without menus |
cinnamon play-url <url> |
Play any m3u8/mp4 link |
cinnamon resume |
Continue an interrupted download |
cinnamon history |
Show watch history |
cinnamon history <query> |
Show episodes played for a show and continue from next |
cinnamon history clear |
Clear all watch history |
cinnamon history toggle [on/off] |
Enable or disable history tracking |
cinnamon config history show |
Show whether history tracking is enabled |
cinnamon config history toggle [on/off] |
Enable or disable via config |
cinnamon scrapers |
See available streaming sources |
cinnamon install <name> |
Add an optional scraper (vidsrc, torrentio) |
cinnamon update |
Check for and install the latest version |
cinnamon config show |
View your settings |
Common flags
| Flag | What it does |
|---|---|
-s <N> |
Season number |
-e <N> or -e <start-end> |
Episode or range (e.g. -e 1-10) |
-d |
Download instead of streaming |
--scraper <name> |
Force a specific scraper |
--player mpv or --player vlc |
Choose player |
-q 720p |
Pick quality (480p, 720p, 1080p, best, worst) |
--sub |
Prefer subtitled audio (skips the translation prompt) |
--dub |
Prefer dubbed audio (skips the translation prompt) |
--info-only |
Just print the stream URL |
Scrapers (streaming sources)
Built-in (work out of the box):
| Name | For |
|---|---|
webstream |
TV shows & movies from vixsrc.to and vidlink.pro (HLS) |
anime |
Anime from allanime.day via mp4upload |
Optional (install with cinnamon install <name>):
| Name | Needs |
|---|---|
vidsrc |
pip install "cinnamon[scrapers]" then playwright install chromium |
torrentio |
npm install (torrent playback) |
cinnamon install torrentio
cinnamon config default-scraper torrentio
Configuration
Settings are stored in ~/.config/cinnamon/config.json (Linux/macOS/Termux) or %APPDATA%/cinnamon/config.json (Windows). Change them anytime:
cinnamon config default-player mpv
cinnamon config default-scraper webstream
cinnamon config set-api-key YOUR_KEY
Notes
Anime movies now work (both sub and dub). Use --sub or --dub to pick your translation, or just run the command and it will ask.
This project is mostly vibe coded and our lazy ass didnt even write more than 300 lines of code. feel free to give us feedback so we can improve this project and make it as good as possible.
inspired by ani-cli
1 maintainer
Release files for cinnamon-cli 0.2.39
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cinnamon_cli-0.2.39.tar.gz | 66.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cinnamon_cli-0.2.39-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 128.8 kB
Release files / cinnamon_cli-0.2.39.tar.gz
| Download URL | cinnamon_cli-0.2.39.tar.gz |
|---|---|
| Size | 66.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e48c0da7b2383ef25f4f56e9b0cfd031ca75157f1b7b3ee33b6b2447d0e6baf7
|
|
BLAKE2b-256 checksum How to use checksums |
e4573be7ceddf27f2bcbbd6df8267bd20456cb8005c0cbaee5f7da1451ba22fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Release files / cinnamon_cli-0.2.39-py3-none-any.whl
| Download URL | cinnamon_cli-0.2.39-py3-none-any.whl |
|---|---|
| Size | 62.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7351fb3c35e16034cc247afe6849ef8e5607df194c6b4cb7b6de617c931c4ae6
|
|
BLAKE2b-256 checksum How to use checksums |
af9713888e0848742f31c14f7b78283ff68f1c42cf2f0f7ebad296babcc3b643
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
