VibraVid

DRM HLS/DASH downloader.

Installation

Option 1 — Manual Clone

git clone https://github.com/AstraeLabs/VibraVid.git
cd VibraVid

Then install and run with either pip or uv:

pip:

pip install -r requirements.txt   # install
python manual.py                  # run
pip install -r requirements.txt --upgrade  # sync deps

uv:

uv sync              # install
uv run manual.py     # run
uv sync --upgrade    # sync deps

Option 2 — Unraid

You can find the app in the Community Application

Option 3 — Android/Termux (automatic)

Important

This script requires Termux. Do NOT install Termux from the Google Play Store, as that version is outdated and abandoned due to Android policy restrictions. Instead, download the latest official version from:

📥 F-Droid
📥 GitHub Releases

Once you have installed Termux, open the app, copy the command below, paste it into the terminal, and press Enter to run the automatic installation (it will download VibraVid, compile all necessary components including Velora, and configure the storage folder):

curl -sL https://raw.githubusercontent.com/ManoloZocco/StreamingCommunity/main/termux_install.sh | bash

Once the installation is complete, you can launch the app at any time by simply typing:

vibravid

Additional Documentation

📝 Login Guide — Authentication for supported services
🖥️ NAS Deployment Guide — Docker setup on Synology, TrueNAS, and other NAS devices

Quick Start

python manual.py

Update

Binary (Windows / macOS / Linux)

VibraVid -UP

Manual clone

git fetch origin
git reset --hard origin/main

Then sync dependencies:

pip:

pip install -r requirements.txt --upgrade

uv:

uv sync --upgrade

Note

If the folder is not yet an initialized Git repository:

git init
git remote add origin https://github.com/AstraeLabs/VibraVid.git
git fetch origin
git reset --hard origin/main

Warning

Folders ignored by .gitignore (e.g. Video/) will not be deleted.

Downloaders

Type	Description	Example
HLS	HTTP Live Streaming (m3u8)	View example
MP4	Direct MP4 download	View example
DASH	MPEG-DASH with DRM bypass*	View example
ISM	Smooth Streaming with DRM bypass*	View example
Custom	Multi-source hybrid	View example

*DASH with DRM bypass: Requires a valid L3\L2\L1\SL3000\SL2000 CDM (Content Decryption Module). This project does not provide or facilitate obtaining CDMs. Users must ensure compliance with applicable laws.

Custom multi-source downloads

Generic_Downloader takes a list of sources, downloads every selected track from every source concurrently on one shared progress bar, then muxes them into a single file — including hybrid Dolby Vision + HDR10 output (the DV RPU is injected into the HDR10 base via mkvmerge/dovi_tool).

When sources are full manifests (DASH MPD, HLS master) the tracks are auto-selected from the advertised codec/resolution/range.

from VibraVid.core.downloader import Generic_Downloader

sources = [
    {"role": "video:hdr10", "url": "<hdr10 m3u8>", "key": "<kid:key>"},
    {"role": "video:dv", "url": "<dv m3u8>", "key": "<kid:key>"},
    {"role": "audio", "language": "en", "url": "<audio m3u8>", "key": "<kid:key>"},
    {"role": "subtitle", "language": "en", "url": "<sub url>"},
]

Generic_Downloader(sources=sources, output_path="./Video/out.mkv").start()

Supported role values: video, video:dv, video:hdr10 (or any range tag), audio, subtitle. A video:dv source is automatically routed as the Dolby Vision companion for hybrid muxing. Optional per-source fields: language, name, label, headers, cookies, protocol. Limit a test run with max_segments=N or max_time="HH:MM:SS", or grab a specific clip with a range: max_segments="10-50" or max_time="00:01:00-00:05:00".

MammaMia — Stremio addon for Italian streaming (by UrloMythus)
Unit3Dup — Torrent automation for Unit3D tracker (by 31December99)
N_m3u8DL-RE — Universal downloader for HLS/DASH/ISM (by nilaoda)
pywidevine — Widevine L3 decryption library (by devine-dl)
pyplayready — PlayReady decryption library (by ready-dl)

Disclaimer