Metadata-Version: 2.4
Name: sakazuki-beats-shanks
Version: 1.0.0
Summary: A resumable, ARM7/Termux-friendly CLI video downloader with big meme energy.
License: MIT
Project-URL: Homepage, https://pypi.org/project/sakazuki-beats-shanks/
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28
Requires-Dist: rich>=13.0
Requires-Dist: InquirerPy>=0.3.4
Requires-Dist: tqdm>=4.64
Requires-Dist: pyfiglet>=1.0

# sakazuki-beats-shanks

A resumable, multi-threaded CLI video downloader with HLS support and big meme energy.
Pure Python — zero Rust, zero native extensions — so it runs fine on **ARM7 Termux** (2 GB phones).

## Install

```bash
pip install -U sakazuki-beats-shanks
pkg install ffmpeg        # required for muxing segments
```

## Usage

```bash
sakazuki                          # fully interactive
sakazuki "naruto"                 # search then pick episodes interactively
sakazuki "naruto" -e 1-26         # episodes 1–26
sakazuki "naruto" --all           # every episode
sakazuki "naruto" -e 1,3,7        # specific episodes
sakazuki "naruto" -r 720 -l dub   # 720p dub
sakazuki "one piece" -e 1-100 -r 1080 -d /sdcard/Downloads

sakazuki --set-dir /sdcard/Downloads  # save default download folder
sakazuki --refresh-index              # force-rebuild the local title index
```

## Options

| Flag | Default | Description |
|---|---|---|
| `-e`, `--episodes` | interactive | Episode spec: `1-12`, `all`, `1,3,7`, combinations |
| `--all` | — | Download every episode |
| `-r`, `--resolution` | `1080` | Preferred quality: `1080`, `720`, `480`, `best` |
| `-l`, `--lang` | `sub` | `sub` \| `dub` \| `all` |
| `-d`, `--dir` | `~/Downloads/sakazuki` | Download directory |
| `-t`, `--threads` | `4` | Parallel segment threads |
| `--set-dir DIR` | — | Persist download directory to config |
| `--refresh-index` | — | Rebuild local title cache |

## Resume

If a download is interrupted, re-run the **exact same command**.
Completed segments are cached and skipped. A `.done` marker file is written only
when an episode finishes completely.

## ARM7 Termux notes

All dependencies are pure Python — no Rust toolchain needed.
Optional: install `yt-dlp` for better embed-extraction fallback.

```bash
pip install yt-dlp   # optional but recommended
```

## License

MIT
