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

• Faster downloads: now uses the direct .torrent file URL from nyaa.si instead of the magnet link. This skips the slow DHT metadata lookup (which stalled for 30–120 s before any data would flow) and starts downloading in seconds.
• Better peer discovery: added --enable-peer-exchange, --bt-enable-lpd (LAN peers), --bt-max-peers=0 (unlimited), and tuned DHT/listen ports for maximum throughput.
• Latest releases: the TUI now opens with a mode picker — choose "Latest releases" to see and download the 20 most recently released episodes from all airing shows, or "Browse schedule" to search by show name as before.

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.