VibraVid
DRM HLS/DASH downloader.
Installation
Manual clone
git clone https://github.com/AstraeLabs/VibraVid.git
cd VibraVid
| pip | uv | |
|---|---|---|
| Install | pip install -r requirements.txt |
uv sync |
| Run | python manual.py |
uv run manual.py |
| Sync deps | pip install -r requirements.txt --upgrade |
uv sync --upgrade |
Unraid
Find the app in the Community Applications.
Android/Termux (automatic)
Important
Requires Termux. Do NOT use the Google Play version (outdated and abandoned); get it from F-Droid or GitHub Releases.
In Termux, paste this to download VibraVid, compile the components (including Velora) and set up the storage folder:
curl -sL https://raw.githubusercontent.com/ManoloZocco/StreamingCommunity/main/termux_install.sh | bash
Then launch it any time with vibravid.
See also: Login guide, NAS deployment.
Quick Start
python manual.py
Update
At interactive CLI startup VibraVid checks GitHub Releases in the background (cached 24 h) and prints the command for your installation if a newer release exists. VibraVid --check-update checks on demand; --skip-update-check disables the startup check (auto_check_update = false in config.toml for good).
| Installation | Update |
|---|---|
| Binary (Windows / macOS / Linux) | VibraVid -UP |
| Docker | docker compose pull && docker compose up -d |
| Manual clone | git fetch origin && git reset --hard origin/main, then sync dependencies (table above) |
Folders ignored by .gitignore (e.g. Video/) are not deleted by the reset. If the folder isn't a git repository yet:
git init
git remote add origin https://github.com/AstraeLabs/VibraVid.git
git fetch origin
git reset --hard origin/main
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 downloads every selected track from every source in sources concurrently on one progress bar and muxes them into one file, including hybrid Dolby Vision + HDR10 (the DV RPU is injected into the HDR10 base via mkvmerge/dovi_tool).
Full manifests (DASH MPD, HLS master) are auto-selected by codec/resolution/range, including the DV base/companion pairing with custom_filters={"video": "hybrid"} (see Companion Dolby Vision), across any number of sources and without per-source tagging.
from VibraVid.core.downloader import Generic_Downloader
sources = [
{"url": "<hdr10+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",
custom_filters={"video": "hybrid"},
).start()
role:video,audio,subtitle(a range tag likevideo:hdr10is only a label). Needed only for attribute-less rendition manifests (e.g. Apple TV+) to tell sources apart.- Optional per-source fields:
language,name,label,headers,cookies,protocol. - Test runs:
max_segments=Normax_time="HH:MM:SS"; a clip:max_segments="10-50"ormax_time="00:01:00-00:05:00".
Related Projects
- 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
Warning
This software is for educational and research purposes only. The authors:
- DO NOT assume responsibility for illegal use
- DO NOT provide or facilitate DRM circumvention tools, CDMs, or decryption keys
- DO NOT endorse piracy or copyright infringement
By using this software, you agree to comply with all applicable laws and confirm you have rights to any content you process. No warranty is provided.
Made with ❤️ for streaming lovers — if you find this project useful, consider starring it on GitHub! ⭐