git clone https://github.com/AstraeLabs/VibraVid.git
cd VibraVid
pip install -r requirements.txt
python manual.pyFull installation options (Unraid, Android/Termux, uv), updating, and CLI usage are
covered in the
Installation guide and
CLI usage guide.
📚 Full docs (with search) on the documentation site.
| Topic | |
|---|---|
| ⚙️ Configuration | config.json reference — DEFAULT, OUTPUT, DOWNLOAD (stream selection filters), CODEC, PROCESS, REQUESTS, DRM |
| 💻 CLI Usage | Search, series selection, year filter, track overrides, proxy, direct URL download, download queue |
| 🌐 Web GUI | Django-based browser interface |
| ⌨️ TUI | Terminal user interface (Textual) |
| 🤖 Telegram Bot | Trigger downloads from chat |
| 🔗 ARR Integration | Seerr/Jellyseerr, Sonarr, Radarr automation |
| 🪝 Hook System | Run custom scripts on download lifecycle events |
| 🐳 Docker | Compose, custom ports/paths, private network deployment |
| 🖥️ NAS Deployment | Synology, TrueNAS, Unraid |
| 🌍 Supported Sites | Full list of supported streaming services |
| 🔑 Login Guide | Authentication for supported services |
- 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)
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! ⭐