hauxir
rapidbay
Python

Self-hosted torrent video streaming service compatible with Chromecast, AppleTV & Kodi deployable in the cloud

Last updated Jul 6, 2026
877
Stars
55
Forks
1
Issues
+2
Stars/day
Attention Score
66
Language breakdown
Python 63.6%
JavaScript 25.7%
HTML 6.4%
CSS 3.2%
Dockerfile 0.7%
Shell 0.5%
โ–ธ Files click to expand
README

RapidBay

Rapid bay is a self hosted video service/torrent client that makes playing videos from torrents as easy as:

  • Opening the webapp on a phone/laptop/tablet/smartTV.
  • Searching for content.
  • Selecting desired video file.
  • Waiting for Download/Conversion.
  • Playing on the device or cast to AppleTV/Chromecast

Features:

  • Uses Jackett and/or Prowlarr as a search backend.
  • Pick individual video files you want to play and the system takes care of the rest to make it streamable.
  • Automatic download of Closed Captions/Subtitles
  • Automatically converts the video file and subtitles to be playable on all browsers/chromecast/appletv
  • Automatically converts audio that is unsupported by browsers to AAC
  • Allows registering as a handler for any magnet link
  • Automatically cleans up disk space so you don't need to manage it yourself
  • Kodi support

Demo:

Setting up a search backend:

Rapidbay requires a torrent indexer for searching. You can use Jackett, Prowlarr, or both at the same time (results are merged and deduplicated).

Jackett

Have a look here on how to set Jackett up using Docker. There's also a docker-compose example showing how to connect rapidbay and Jackett together.

Prowlarr

See the Prowlarr docs for installation instructions. There's a docker-compose example showing how to connect rapidbay and Prowlarr together.

Running:

With Docker (recommended)

# Using Jackett
docker run -p 5000:5000 -e JACKETTHOST="http://your.jackett.host" -e JACKETTAPI_KEY="YourAPIKey" hauxir/rapidbay

Using Prowlarr

docker run -p 5000:5000 -e PROWLARRHOST="http://your.prowlarr.host" -e PROWLARRAPI_KEY="YourAPIKey" hauxir/rapidbay

Without Docker

System dependencies:

# Ubuntu/Debian
sudo apt install python3 python3-venv ffmpeg mediainfo nginx

macOS

brew install python ffmpeg mediainfo nginx

Optional: Install alass for subtitle synchronization.

Install Python dependencies:

# Using uv (recommended)
uv sync

Or using pip

python3 -m venv .venv source .venv/bin/activate pip install .

Run the app:

# Set environment variables (Jackett, Prowlarr, or both)
export JACKETT_HOST="http://your.jackett.host"
export JACKETTAPIKEY="YourAPIKey"

export PROWLARR_HOST="http://your.prowlarr.host"

export PROWLARRAPIKEY="YourAPIKey"

Run directly (without nginx)

cd app uvicorn app:app --host 0.0.0.0 --port 5000 --workers 1 --timeout-keep-alive 900

App will be running at http://localhost:5000

Subtitles

You'll need a VIP account at OpenSubtitles.org for it to work:

-e OPENSUBTITLESUSERNAME=someusername -e OPENSUBTITLESPASSWORD=yourpassword

Configuring which subtitles to download:

The default setting downloads english subtitles.

Add the env variable SUBTITLE_LANGUAGES to your docker params like so to get more languages:

-e SUBTITLE_LANGUAGES="['en', 'de', 'es']"

Require a password:

Add the env variable PASSWORD to your docker params like so to prompt for a password when opening rapidbay:

-e PASSWORD=YOURPASSWORD

Registering as a handler for any magnet link:

  • Go to https://\/registerHandler and it should prompt you to register your running RapidBay instance as a default handler for torrent links on any torrent site!
  • You can also copy/paste a magnet link directly into the search bar to open magnet links manually.

Developing

Requires Docker + docker-compose

docker-compose up

Running RapidBay on a VPS

Setting RapidBay up on a VPS and tunnel torrent traffic through NordVPN

Using Kodi as a frontend

Setting up Rapidbay with Kodi

Using debrid caching

  • You can speed up downloads by using a torrent cache from Real Debrid and/or TorBox
  • For Real Debrid, set the env variable RD_TOKEN to the one on https://real-debrid.com/apitoken
  • For TorBox, set the env variable TB_TOKEN to your API key from https://torbox.app/settings
  • If both are set, Real Debrid is tried first and TorBox is used as a fallback

ยฉ 2026 GitRepoTrend ยท hauxir/rapidbay ยท Updated daily from GitHub