explaingit

echo-storm/torbox_manager

8PythonAudience · generalComplexity · 2/5ActiveLicenseSetup · easy

TLDR

Windows desktop queue manager for the TorBox debrid service. Adds magnets, torrents, hoster links, and NZB files to a single download table with file-pick and concurrency controls.

Mindmap

mindmap
  root((TorBox Manager))
    Inputs
      Magnet links
      Torrent files
      Hoster URLs
      NZB files
    Outputs
      Local downloads
      Tray notifications
      Log file
    Use Cases
      Replace Real-Debrid UI
      Queue many downloads
      Pick files from torrents
    Tech Stack
      Python
      Windows
      TorBox API

Things people build with this

USE CASE 1

Manage TorBox downloads from a desktop window instead of a browser tab

USE CASE 2

Queue dozens of magnets and let the app feed them in as slots free up

USE CASE 3

Pick only the files you want from a multi-file torrent before download

USE CASE 4

Migrate a Real-Debrid workflow to TorBox without losing the queue feel

Tech stack

PythonWindowsTorBox API

Getting it running

Difficulty · easy Time to first run · 5min

Download a single exe and paste a TorBox API key on first launch; Windows Defender may flag the fresh binary as a false positive.

MIT licence lets anyone use, modify, and redistribute the code as long as the copyright notice is kept.

In plain English

TorBox Manager is a Windows desktop application that acts as a queue manager for an online service called TorBox. TorBox is a debrid service, which means it downloads files (such as torrents or links from file hosters) on its own servers, scans them, and then offers them back to users as a normal high-speed download. This app gives you a desktop window for that workflow instead of clicking around in a browser tab, and the README notes it is aimed at people switching over from a similar service called Real-Debrid. The app accepts several kinds of input. You can paste magnet links, drop .torrent files, paste links from hosters such as 1Fichier, Mega, or Pixeldrain, and add .nzb files for Usenet. All of these show up in a single table with status, size, seeds and peers (for torrents), and a progress bar. For torrents that contain many files, you can pick which ones you actually want before the download starts. There is a setting to cap how many local downloads run at the same time, and a Download All button that feeds the next item into a free slot as each one finishes. Installation is meant to be light. You download a single file called TorBox_Manager.exe from the Releases page on GitHub, put it anywhere on your machine, and double-click it. There is no installer, no admin rights, no Python install needed. The first launch asks for your TorBox API key (which you copy from your TorBox account page) and a folder to save files into. A config.json and a log file are created next to the executable. Other features the README lists include a right-click menu on each row for copy and open actions, multi-link hoster input where each pasted line gets its own background worker, an update check against GitHub Releases on startup, a minimize-to-tray mode that slows polling to once every five minutes when idle, optional tray pop-ups when downloads finish, and window size memory between sessions. Settings are reachable through a gear icon at the bottom-left. The FAQ addresses Windows Defender flagging the fresh executable as a false positive, explains that some Usenet items briefly show as a hash before TorBox resolves the real name, and notes that running from source is possible with Python 3.10 or newer. Version history runs from v0.1.0 to v0.6.0. The license is MIT.

Copy-paste prompts

Prompt 1
Walk me through setting up TorBox Manager with my API key and a download folder
Prompt 2
Show me how to bulk-paste magnet links and cap the manager to 3 parallel downloads
Prompt 3
Explain how the queue and Download All button interact when items finish
Prompt 4
Help me run TorBox Manager from Python source on Windows instead of the exe
Prompt 5
Add a feature idea to pipe completed downloads into a Plex or Jellyfin library
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.