plugin torrent manager - nself-org/cli GitHub Wiki
Torrent Manager Plugin
Torrent client with Transmission/qBittorrent compatibility and VPN enforcement. Free, MIT licensed.
Install
nself plugin install torrent-manager
What It Does
Manages torrent downloads via a Transmission or qBittorrent-compatible API. Enforces VPN kill-switch behavior so downloads stop if the VPN connection drops. Stores torrent state, file catalog, and download statistics in Postgres. Pairs with the vpn and content-acquisition plugins for a complete automated pipeline.
Configuration
| Env Var | Default | Description |
|---|---|---|
TORRENT_MANAGER_PORT |
3201 |
Service port |
TORRENT_CLIENT |
transmission |
Client backend: transmission or qbittorrent |
TORRENT_CLIENT_HOST |
localhost |
Torrent client host |
TORRENT_CLIENT_PORT |
9091 |
Torrent client port |
TORRENT_DOWNLOAD_DIR |
/downloads |
Download directory |
TORRENT_VPN_ENFORCE |
true |
Kill downloads if VPN disconnects |
Ports
| Port | Purpose |
|---|---|
| 3201 | Torrent manager REST API |
Database Tables
9 tables added to your Postgres database:
np_torrent_manager_torrents, torrent recordsnp_torrent_manager_files, per-torrent file catalognp_torrent_manager_trackers, tracker listnp_torrent_manager_categories, download categoriesnp_torrent_manager_labels, torrent labelsnp_torrent_manager_stats, download statisticsnp_torrent_manager_rules, auto-download rulesnp_torrent_manager_feeds, RSS feed sourcesnp_torrent_manager_history, completed download history
Nginx Routes
| Route | Target |
|---|---|
/torrent/ |
Torrent manager API |