Rapidbay
Self-hosted torrent video streaming service compatible with Chromecast, AppleTV & Kodi deployable in the cloud
Install / Use
/learn @hauxir/RapidbayREADME
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 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 Jackett as a search backend:
Rapidbay requires the torrent indexer Jackett for searching. Have a look here on how to set it up using Docker.
There's also a docker-compose example file to show how you can connect rapidbay and jackett together.
Running:
With Docker (recommended)
docker run -p 5000:5000 -e JACKETT_HOST="http://your.jacket.host" -e JACKETT_API_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
export JACKETT_HOST="http://your.jacket.host"
export JACKETT_API_KEY="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 OPENSUBTITLES_USERNAME=someusername -e OPENSUBTITLES_PASSWORD=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://<RAPIDBAY_HOST>/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
Using Real Debrid caching
- You can speed up downloads by using the torrent cache at real debrid
- To do that set the env variable RD_TOKEN to the one on https://real-debrid.com/apitoken
Related Skills
tmux
336.9kRemote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
claude-opus-4-5-migration
83.0kMigrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5
model-usage
336.9kUse CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
blogwatcher
336.9kMonitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
