subsplease-dl 0.3.3

CLI downloader for SubsPlease.org anime releases with tmux session management

subsplease-dl

A pip-installable CLI downloader for 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):

# 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

# 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.