Introduction
upbrr is an upload preparation app for private-tracker workflows. It combines metadata, duplicate checks, screenshots, image hosting, descriptions, tracker payload review, submission, and torrent-client injection in one workspace.
Quality-check every upload. Confirm the generated name, category, type, source, resolution, edition, description, images, torrent contents, and client settings against current tracker rules before submission.
Intended audience
upbrr is for uploaders who already understand:
- release naming and media classification;
- tracker categories, types, and upload rules;
- duplicate and trumping decisions;
- screenshot and description requirements;
- torrent creation, cross-seeding, and client injection.
It guides those tasks. It does not replace tracker rules, staff direction, or operator judgment.
What upbrr does
A normal workflow can:
- inspect a release folder or file;
- fetch metadata and let you correct it;
- prepare tracker-specific upload and search names;
- run duplicate searches and eligibility checks;
- generate or import screenshots and disc-menu images;
- upload selected images to configured hosts;
- build and preview tracker descriptions;
- prepare immutable tracker payload previews;
- submit approved uploads;
- retain tracker-registered torrents and inject them into configured clients.
The embedded Web UI and CLI share the same configuration, preparation services, tracker adapters, and durable workflow state.
Safety boundaries
- Duplicate results and tracker warnings need manual review.
--debugruns the workflow without tracker submission. It can still perform local and remote preparation work and inject into clients unless--no-seedis also set.--unattendednever prompts. Missing global decisions stop the run; tracker-specific manual prerequisites can leave only that tracker blocked.- Tracker credentials, cookies, and API keys must never appear in issue reports or shared diagnostics.
Continue with the quick start, or read the workflow explanation first.