Metadata-Version: 2.4
Name: sakazuki-dogwalks-yonkos
Version: 0.1.0
Summary: cinemaos.live video downloader CLI
Project-URL: Homepage, https://pypi.org/project/sakazuki-dogwalks-yonkos/
License: MIT
Keywords: cinemaos,cli,downloader,streaming,video
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.10
Requires-Dist: inquirerpy>=0.3.4
Requires-Dist: pycryptodome>=3.20.0
Requires-Dist: pyfiglet>=1.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tqdm>=4.65.0
Description-Content-Type: text/markdown

# 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

```bash
pip install sakazuki-dogwalks-yonkos
```

## Quick Start

```bash
# 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](https://www.themoviedb.org/signup)
2. Go to **Settings → API** and copy your *Read Access Token (v4 auth)*
3. Save it:

```bash
sdyonkos --set-tmdb-token
```

Or export it in your shell:

```bash
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
