pizza-droid/cinnamon

Cinnamon is a command line tool for watching TV shows, movies, and anime directly from your terminal. You search for a title, pick an episode, and it plays through an external video player like mpv or VLC instead of a web browser. Getting started requires Python 3.10 or newer plus one of those two players installed separately. A setup wizard can optionally connect to The Movie Database for show and movie information, skipping that step falls back to an alternate search method that works but is described as less reliable. Anime titles are searched through AniList and do not require any API key. Beyond just playing a title, Cinnamon supports jumping straight to a specific season and episode, choosing subtitled or dubbed audio for anime, picking a video quality, and downloading episodes instead of streaming them, which requires the separate tool yt-dlp. It also keeps a watch history you can view, continue from, or clear, and it can resume an interrupted download. The project uses a system of scrapers, meaning different sources it pulls streams from. Two work out of the box for shows, movies, and anime. Two more optional scrapers can be installed separately, one of which needs a browser automation tool and the other of which adds torrent based playback. All settings, including the default player and the default scraper, are stored in a local config file that can be changed with commands. The README notes that anime movies do not currently work because of how the scrapers are built, though the maintainers say this will be fixed. The project is described by its own authors as a small, mostly vibe coded effort, and it was inspired by an existing terminal based anime player. It is licensed under Creative Commons Attribution NonCommercial 4.0, which does not permit commercial use.