sakazuki-dogwalks-yonkos 0.1.0

cinemaos.live video downloader CLI

sakazuki-dogwalks-yonkos

A cinemaos.live video downloader CLI — download movies and TV episodes straight to your machine.

Requires ffmpeg installed on your system.

---

Installation

pip install sakazuki-dogwalks-yonkos

Quick Start

# Interactive search (requires TMDB token — see below)
sdyonkos "Oppenheimer"

# Download by TMDB ID directly (no TMDB token needed)
sdyonkos --id 872585 --type movie

# TV show by ID — picks season/episode interactively
sdyonkos --id 94997 --type tv

# TV show — specify season and episode directly
sdyonkos --id 94997 --type tv --season 1 --episode 3

# Force a specific server
sdyonkos --id 872585 --server Helios

# List available servers without downloading
sdyonkos --id 872585 --servers

Setup: TMDB Token

To use the title search feature you need a free TMDB Read Access Token:

1. Sign up at themoviedb.org
2. Go to Settings → API and copy your Read Access Token (v4 auth)
3. Save it:

sdyonkos --set-tmdb-token

Or export it in your shell:

export TMDB_READ_TOKEN="your_token_here"

CLI Reference

Command	Description
sdyonkos "title"	Search and download interactively
sdyonkos --id <ID>	Download by TMDB ID
sdyonkos --id <ID> --type tv	Download TV (prompts for season/episode)
sdyonkos --id <ID> --season 1 --episode 2	Specific episode
sdyonkos --id <ID> --servers	List available servers
sdyonkos --id <ID> --server Helios	Force server
sdyonkos --id <ID> --quality 1080	Pick quality (MP4 servers)
sdyonkos --output ~/Videos	Override download directory
sdyonkos --config	Show current config
sdyonkos --set-tmdb-token	Save TMDB token
sdyonkos --set-output-dir ~/Videos	Save default download dir
sdyonkos --reset-config	Reset all settings

Available Servers

cinemaos.live exposes multiple servers. HLS servers (Helios, Selene, Eos, Nyx, Orion) stream via m3u8 and are downloaded using ffmpeg. CineAstra provides direct MP4 links at multiple resolutions.

License

MIT