explaingit

elfhosted/litterbox

Analysis updated 2026-05-18

16HTMLAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

LitterBox is a self hosted web app that signs into your Real-Debrid account, finds broken or filtered torrents in your library, and lets you bulk-delete them safely.

Mindmap

mindmap
  root((LitterBox))
    What it does
      Detect broken torrents
      Bulk delete
      OAuth sign in
    Tech stack
      Go
      HTML
      JavaScript
    Use cases
      Clean Real-Debrid library
      Deep scan for filters
      Self host with Docker
    Audience
      Self hosters
      Real-Debrid users
    Requirements
      Go
      Docker optional

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find and bulk delete broken or dead torrents from your Real-Debrid library

USE CASE 2

Sign in to Real-Debrid without ever entering an API key

USE CASE 3

Run a deep scan to catch torrents affected by Real-Debrid's filtering that don't show up normally

USE CASE 4

Self host the tool with Docker or a single Go binary

What is it built with?

GoHTMLJavaScript

How does it compare?

elfhosted/litterboxaayan15728/aesthetic-portfolio-siteandrisgauracs/interfaze_ocr_viewer
Stars161616
LanguageHTMLHTMLHTML
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneraldeveloperdata

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Runs as a single Go binary or Docker container with no database or secrets required.

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

In plain English

LitterBox is a small web app for cleaning up a Real-Debrid library, which is a service some people use to store and stream torrents. After a mass-banning event on Real-Debrid, many users ended up with libraries full of broken, dead, or virus-flagged torrents, and deleting them one by one through the official interface was painfully slow. LitterBox counts those broken items and lets you bulk-delete them with a type-to-confirm safety step. Signing in uses Real-Debrid's own login flow (OAuth), so you never type an API key into the app. Your login token is stored only in your browser, not on any server. The app does run a small proxy on its backend, but that proxy exists only because Real-Debrid's API does not allow direct browser requests, it forwards your request without logging or storing anything, using an allowlist of hostnames it is permitted to talk to. Detecting broken torrents is not straightforward, since Real-Debrid's filtering does not show up cleanly in the normal library listing. LitterBox uses two passes: a fast, built-in pattern match against known filename patterns associated with the filtering issue, and an optional deeper scan that checks each torrent individually against the real API signal, which is slower but more accurate. Results from that deeper scan feed into a community system: the browser looks for filename patterns that correlate with broken torrents but are not yet covered by the built-in pattern, and lets a user copy a report to share on the project's Reddit community so the maintainers can review and add well supported patterns to a future release. LitterBox is written in Go and ships as a single binary, so running it locally is a matter of building and starting it, or running it in a Docker container. It stores no database and no secrets server-side. The project is MIT licensed, and the same team also runs a hosted public version, along with a separate paid product for migrating away from Real-Debrid entirely once a library is too far gone to be worth cleaning.

Copy-paste prompts

Prompt 1
Help me build and run LitterBox locally with Go so I can clean my Real-Debrid library
Prompt 2
Explain how LitterBox detects torrents affected by Real-Debrid's filtering
Prompt 3
Walk me through deploying LitterBox in a Docker container
Prompt 4
What data does LitterBox's proxy actually see and store about my account

Frequently asked questions

What is litterbox?

LitterBox is a self hosted web app that signs into your Real-Debrid account, finds broken or filtered torrents in your library, and lets you bulk-delete them safely.

What language is litterbox written in?

Mainly HTML. The stack also includes Go, HTML, JavaScript.

What license does litterbox use?

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is litterbox to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is litterbox for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.