Metadata-Version: 2.4
Name: subsplease-dl
Version: 0.3.3
Summary: CLI downloader for SubsPlease.org anime releases with tmux session management
Author: subsplease-dl contributors
License: MIT
License-File: LICENSE
Keywords: anime,downloader,subsplease,tmux,torrent
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.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet
Classifier: Topic :: Multimedia
Requires-Python: >=3.9
Requires-Dist: click>=8.0
Requires-Dist: libtmux>=0.28
Requires-Dist: questionary>=2.0
Requires-Dist: requests>=2.28
Requires-Dist: rich>=13.0
Requires-Dist: tomli-w>=1.0
Requires-Dist: tomli>=2.0; python_version < '3.11'
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-mock; extra == 'dev'
Requires-Dist: responses; extra == 'dev'
Description-Content-Type: text/markdown

# subsplease-dl

A pip-installable CLI downloader for [SubsPlease.org](https://subsplease.org/) with tmux session management — inspired by `animepahe-dl-tmux`.

```
pip install subsplease-dl
```

## Requirements

- Python 3.9+
- A torrent client: **aria2c** (recommended), `webtorrent-cli`, or `transmission-cli`
- `tmux` for background download sessions (optional but recommended)

**Install aria2 (recommended torrent client):**

```bash
# Termux (Android)
pkg install aria2

# Ubuntu/Debian
sudo apt install aria2

# macOS
brew install aria2

# Or use webtorrent-cli
npm install -g webtorrent-cli
```

## Quick Start

```bash
# Interactive TUI — search and pick episodes
subs

# Download latest releases
subsplease-dl latest

# Search and download a specific show
subsplease-dl search "one piece"
```

## Changelog

### 0.3.3
- Fix crash (`FileNotFoundError: aria2c`) when no torrent client is installed: now shows a clear, friendly error message with install instructions instead of a stack trace.
- Stop hardcoding `aria2c` as the default client when it is not present — auto-detection now works correctly.

### 0.3.2
- Fix `AttributeError: 'str' object has no attribute 'get'` crash caused by the SubsPlease API changing the `episode` field from a list of dicts to a dict keyed by "Show - Episode". Both formats are now handled transparently.
