explaingit

hotheadhacker/seedbox-lite

4,498JavaScriptAudience · generalComplexity · 3/5Setup · moderate

TLDR

A self-hosted web app that lets you stream video from a torrent link in your browser almost instantly, no waiting for the full download, deployed on your own server with Docker or Node.js.

Mindmap

mindmap
  root((SeedBox Lite))
    What it does
      Stream torrents in browser
      No full download needed
      Self-hosted service
    Features
      Auto subtitle loading
      Password protection
      Mobile-friendly UI
      iOS and Android support
    Tech Stack
      Node.js backend
      React frontend
      Docker deployment
    Supported Formats
      MP4 and MKV
      AVI and others
    Audience
      Home server users
      Self-hosters
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Stream a video from a torrent link in your browser without waiting for the full file to finish downloading.

USE CASE 2

Host a private, password-protected video player on your own home server or VPS.

USE CASE 3

Watch torrented video on your phone with iOS Safari or Android Chrome, with automatic subtitle loading.

Tech stack

JavaScriptNode.jsReactDocker

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Docker or Node.js 18+, consider the legal status of torrenting in your jurisdiction before deploying.

No license information is specified in the repository.

In plain English

SeedBox Lite is a self-hosted web application that lets you stream video from a torrent link without waiting for the full file to finish downloading. You give it a torrent, it starts downloading in the background, and you can begin watching in your browser almost immediately. The interface is designed to look and feel like a standard video streaming service. The application has two parts: a Node.js backend that handles the torrent downloading and video serving, and a React frontend that provides the browser interface. You deploy both on your own server or computer, then access the player from any browser on your network. Supported video formats include MP4, MKV, AVI, and others. Subtitles are detected and loaded automatically when available. The interface is built to work well on mobile devices as well as desktop browsers, with gesture controls and full support for iOS Safari and Android Chrome. Access is protected by a password you set during configuration. The README lists Docker as the recommended way to get everything running quickly, with a single docker-compose command starting both the backend and frontend. A PM2-based setup is also described for those who prefer to run Node.js processes directly without containers. Both approaches require Node.js 18 or newer. The project supports Windows, macOS, and several Linux distributions. The README includes sections on environment variable configuration, health check endpoints, and testing commands. No specific license is mentioned in the README itself. The project is described as production-ready, though users should consider the legal status of torrenting in their jurisdiction before deploying it.

Copy-paste prompts

Prompt 1
Show me how to deploy hotheadhacker/seedbox-lite using Docker Compose on a Linux server. Include a docker-compose.yml, the environment variables needed, and how to access the player after it starts.
Prompt 2
How do I set a password and configure the port for my SeedBox Lite instance? Show the environment variable settings and where to apply them.
Prompt 3
I want to run seedbox-lite without Docker using PM2. Walk me through cloning the repo, installing dependencies, and starting both the backend and frontend with PM2 on Node.js 18.
Prompt 4
My SeedBox Lite instance is running. How do I add a torrent magnet link, start streaming, and verify that subtitles are loading automatically for an MKV file?
Open on GitHub → Explain another repo

← hotheadhacker on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.