whatisgithub

What is streampicker?

arah91-bit/streampicker — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · generalComplexity · 3/5Setup · moderate

In one sentence

A self-hosted tool that races multiple streaming sources, verifies playback, and hands your media player the best working stream.

Mindmap

mindmap
  root((StreamPicker))
    What it does
      Races multiple stream sources
      Verifies playback before serving
      Ranks stream quality
    Tech stack
      Python
      Docker
      Docker Compose
    Use cases
      Self host a stream picker
      Connect debrid services
      Add custom addons
    Audience
      Self hosters
      Media enthusiasts
    Features
      Fast and best quality pickers
      Encrypted settings
      Guided browser setup

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

Self host a stream picker that finds and verifies the best quality stream for your media player.

USE CASE 2

Connect a debrid service like Real-Debrid or TorBox and let StreamPicker rank the fastest working stream.

USE CASE 3

Add custom addon manifest URLs to widen your source coverage without duplicating playback checks.

USE CASE 4

Run a fast picker and a best quality picker side by side from the same Docker container.

What is it built with?

PythonDockerDocker Compose

How does it compare?

arah91-bit/streampicker1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/51/5
Audiencegeneralvibe codervibe coder

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Docker Compose plus your own debrid, usenet or metadata provider accounts.

Unknown from the shown README, check the repository license file for exact terms.

So what is it?

StreamPicker, also called Auto Stream, is a self hosted tool that sits in front of your media player and picks the best working stream for whatever you want to watch. It races several sources at once, whether that is a debrid service or a direct usenet source, actually checks that the top result plays before handing it over, and aims to give you a high quality stream with the correct audio track. The project ships two versions of the same addon from one container, a fast picker that answers within a couple of seconds, and a best quality picker that waits longer and ranks its results more carefully. There is also an optional read ahead buffer on disk that helps smooth over playback when a source is flaky. Everything is set up through a browser dashboard rather than editing files by hand, although files remain an option too. Installing it means running Docker with the Compose plugin, pulling a prebuilt image with two curl commands and a docker compose up, then opening the dashboard in a browser. The first visit walks you through creating an admin account, after which a guided setup shows a simple checklist of sources, storage locations, automation tools and metadata providers, letting you switch on only the pieces you actually use. Supported debrid services include TorBox, Real-Debrid, AllDebrid and Premiumize, and the tool can also work from usenet indexers, a Jellyfin library, or other addons instead of a debrid account. Security is built in from the start. The dashboard itself is authenticated and only answers to local network requests by default, keeping it separate from the addon endpoints, which are meant to be reached from outside and instead rely on a long, unguessable secret in their URL. Sensitive settings saved through the dashboard are encrypted at rest rather than stored as plain text. The Settings page also supports adding custom addons by pasting in any player addon's manifest URL, and results from every connected source are merged into one ranked list, with duplicate releases recognized across addons so extra sources add coverage without duplicating verification work.

Copy-paste prompts

Prompt 1
Explain how StreamPicker verifies that a stream actually plays before handing it to my player.
Prompt 2
Walk me through deploying StreamPicker with Docker Compose and setting ADDON_SECRET.
Prompt 3
Show me how to connect a debrid service like Real-Debrid to StreamPicker's guided setup.
Prompt 4
Help me add a custom addon manifest URL to StreamPicker's Settings page.

Frequently asked questions

What is streampicker?

A self-hosted tool that races multiple streaming sources, verifies playback, and hands your media player the best working stream.

What language is streampicker written in?

Mainly Python. The stack also includes Python, Docker, Docker Compose.

What license does streampicker use?

Unknown from the shown README, check the repository license file for exact terms.

How hard is streampicker to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is streampicker for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.