VibraVid
Docker app from Yusseiin's Repository
VibraVid - Web UI for managing video downloads.
Overview
Readme
View on GitHubQuick Start
git clone https://github.com/AstraeLabs/VibraVid.git
cd VibraVid
pip install -r requirements.txt
python manual.py
Full installation options (Unraid, Android/Termux, uv), updating, and CLI usage are
covered in the
Installation guide and
CLI usage guide.
Documentation
π Full docs (with search) on the documentation site.
| Topic | |
|---|---|
| βοΈ Configuration | config.toml 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 |
| π Login Guide | Authentication for supported services |
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)
- VibraVid for Android β Android version of VibraVid (by Lumus122)
Disclaimer
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! β
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/astraelabs/vibravid:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8000]- Network
bridge- Shell
bash- Privileged
- false
Template configuration
HTTP port for the VibraVid web interface.
- Target
- 8000
- Default
- 8000
- Value
- 8000
Where downloaded videos are stored.
- Target
- /app/Video
- Default
- /mnt/user/downloads/vibravid
- Value
- /mnt/user/downloads/vibravid
Holds config.json and login.json. Must be pre-seeded by the one-time setup script (see Overview).
- Target
- /app/Conf
- Default
- /mnt/user/appdata/vibravid/Conf
- Value
- /mnt/user/appdata/vibravid/Conf
SQLite database FILE (not a directory). Must exist on the host before first start - the setup script touches an empty file that Django will populate via migrate.
- Target
- /app/GUI/db.sqlite3
- Default
- /mnt/user/appdata/vibravid/db.sqlite3
- Value
- /mnt/user/appdata/vibravid/db.sqlite3
Application logs.
- Target
- /app/logs
- Default
- /mnt/user/appdata/vibravid/logs
- Value
- /mnt/user/appdata/vibravid/logs
Secret key for Django sessions/CSRF. CHANGE this to a long random string before exposing the app.
- Target
- DJANGO_SECRET_KEY
- Value
- change-me-to-a-secure-key
Comma-separated hostnames/IPs allowed to reach the app. Add your Unraid IP, e.g. localhost,127.0.0.1,192.168.1.50
- Target
- ALLOWED_HOSTS
- Default
- localhost,127.0.0.1
- Value
- localhost,127.0.0.1
Comma-separated origins trusted for CSRF. Must include the exact scheme://host:port you use to reach the WebUI.
- Target
- CSRF_TRUSTED_ORIGINS
- Default
- http://localhost:8000,http://127.0.0.1:8000
- Value
- http://localhost:8000,http://127.0.0.1:8000
Optional. Free API key from themoviedb.org/settings/api. Enables TMDB filename tokens, poster/backdrop artwork and strict TMDB/TVDB matching for ARR. Read at startup: restart the container after changing it. Replaces the deprecated tmdb key in Conf/login.
- Target
- TMDB_API_KEY
Enable Django debug mode. Leave false for normal use.
- Target
- DJANGO_DEBUG
- Default
- false
- Value
- false
Optional. Interval in seconds between watchlist auto-downloads (e.g. 14400 for 4 hours). Leave blank to disable.
- Target
- WATCHLIST_AUTO_INTERVAL_SECONDS