需先按 requirements.txt 安装 Python 依赖才能运行;部分服务需登录认证,参见 Login Guide;DRM 相关内容 README 声明不提供解密工具或密钥
git clone https://github.com/AstraeLabs/VibraVid.git
cd VibraVid
pip install -r requirements.txt
python manual.pyREADME 未说明
下载电影、剧集、动漫、专辑和歌曲,支持 DASH/HLS/ISM/MP4 流
支持电影、剧集、动漫、专辑和歌曲的下载工具,能处理 DASH、HLS、ISM 等流媒体格式及 MP4 文件,适合离线保存音视频内容。
核心能力
- 支持 DASH、HLS、ISM、MP4 多种流格式下载
- 提供 CLI、Web GUI、TUI 和 Telegram Bot 多种操作入口
- 可接入 Seerr/Jellyseerr、Sonarr、Radarr 实现自动化
- 通过 Hook 系统在下载生命周期事件触发自定义脚本
- 支持 Docker 与 NAS(Synology、TrueNAS、Unraid)部署
容易踩的坑
- v1.5.0最新正式版2026-11-09 · 2026-11-09 07:39 UTC
What's Changed
- [Anime] Fix folder and audio selection @filips2302 in https://github.com/AstraeLabs/VibraVid/pull/801
- [Anime] Fix vixcloud 403 and missing VideoSourceAnime init by @Ximer612 in https://github.com/AstraeLabs/VibraVid/pull/805
Full Changelog: https://github.com/AstraeLabs/VibraVid/compare/v1.4.9...v1.5.0
- v1.4.92026-10-30 · 2026-10-30 13:19 UTC
查看更新说明
Full Changelog: https://github.com/AstraeLabs/VibraVid/compare/v1.4.9...v1.4.9
- v1.4.82026-10-23 · 2026-10-23 08:51 UTC
查看更新说明
Changelog
Migration and breaking changes
- TOML configuration:
Conf/config.jsonandConf/login.jsonare replaced byconfig.tomlandlogin.toml. extra_args→args: a service's persistent CLI options now live under theargskey of itslogin.tomlsection.- New binary layout: managed executables move from
<binary_dir>/<tool>to<binary_dir>/tools/<tool>(Windows:C:\binary\VibraVid\tools; Linux/macOS:.../binary/VibraVid/tools). CDMs go inwvd/andprd/;.wvd/.prdfiles left in the old flat directory are still found, executables are not. --down-jsonreplaced by--import, fed by files created with the new--export.--drmno longer acceptsauto: valid values arewidevine/playready(aliaseswv/pr).- Removed
DEFAULT.debug_track_json,REQUESTS.bypasser_urlandDRM.prefer_remote_cdm. - Removed the built-in services
7movies,discovery,dmax,foodnetwork,homegardentv,nove,monochromeandrealtime(merged intoaurora). - Removed the Amazon provider, the Docker
bypassersidecar and the--amazon-music-login/--amazon-music-logoutflags.
Core
Downloader and pipeline
- New
--export/--importflow: resolves tracks and keys and writes a JSON file (default.cache/export/<site>_<type>_<title>.json). - New
DownloadFailedexception: errors already explained on screen no longer print a traceback. - More robust temporary-directory cleanup: rename to a
.trash-<pid>-<id>folder, detached deletion, Windows long-path handling (\\?\), retries on read-only/locked files, sweeping leftovers from previous runs and handling Job objects that terminate child processes.
DRM
- Unified CDM selection with precedence
--cdm→ servicecdminlogin.toml→[DRM] cdminconfig.toml. - Per-quality rules (
min_height/max_height), with the CDM chosen based on the highest selected video resolution;searchperforms automatic file discovery anddefaultdelegates to the next level. - Support for multiple named remote CDMs in
[DRM.remote_cdm], with type, security level and system detected automatically.
Muxing and subtitles
- Automatic font embedding for ASS/SSA subtitles: system fonts (Windows registry,
fc-liston Linux, macOS folders) and a fallback pool, attached with both ffmpeg and mkvmerge. - Chapters clamped to the actual media duration; the last chapter ends with the file instead of staying open.
- HDR/DV detection shared between DASH/HLS parsers, and the
dv_autofilter also applied to streams not explicitly flagged as DV.
Services
Removed
discovery,dmax,foodnetwork,homegardentv,noverealtime(renamed and expanded intoaurora)
CLI
--export [FILE]and--import FILEinstead of--down-json.- Automatic update of managed binaries every 2 days (
auto_update_binaries), with backup and rollback on failed downloads.
TUI
- Manual track selection with a video/audio/subtitle modal.
- Settings: service and
login.tomlcredential management, with "configured / needs setup" status and notes for CDM, args and cookies. - Refresh of external
imp_serviceservices from the TUI too. ServiceExit: a service'ssys.exit()becomes an error message instead of closing the app.
GUI
- Built-in
config.tomlandlogin.tomleditor with server-side TOML validation and.backupfile. - Structured edits that preserve comments and the rest of the file (e.g. the ARR section and per-service
args). - System page: hidden-service list, config/login editor, external repository refresh.
- The update banner honors
auto_check_update.
Setup, build and dependencies
- New
VibraVid/tools,VibraVid/wvd,VibraVid/prdlayout; configurable CDM directories. - Docker: removed the
bypassersidecar, updated paths toconfig.toml, addedVIBRAVID_HIDDEN_SITES. - Telegram bot u
- TOML configuration:
- v1.4.72026-10-16 · 2026-10-16 13:29 UTC
查看更新说明
What's Changed
- fix(ci): correct testing workflow step indentation by @DanielVd in https://github.com/AstraeLabs/VibraVid/pull/759
- fix(telegram): remove duplicate credentials from env example by @DanielVd in https://github.com/AstraeLabs/VibraVid/pull/757
- fix(security): avoid logging ARR webhook credentials and payloads by @DanielVd in https://github.com/AstraeLabs/VibraVid/pull/760
- feat(gui): schedule a download for a chosen day and time by @Omixxx in https://github.com/AstraeLabs/VibraVid/pull/761
- fix(security): redact signed URLs in Velora bridge logs by @DanielVd in https://github.com/AstraeLabs/VibraVid/pull/762
- update la7 by @Syncs-Luca98 in https://github.com/AstraeLabs/VibraVid/pull/763
- Add safe GitHub release update checks to CLI and TUI by @username77 in https://github.com/AstraeLabs/VibraVid/pull/765
- feat(gui): add interactive per-download track selection by @DanielVd in https://github.com/AstraeLabs/VibraVid/pull/764
- update scrapper raiplay by @Syncs-Luca98 in https://github.com/AstraeLabs/VibraVid/pull/767
- nuovo servizio tvision by @Syncs-Luca98 in https://github.com/AstraeLabs/VibraVid/pull/769
- servizio yt-music by @Syncs-Luca98 in https://github.com/AstraeLabs/VibraVid/pull/770
- services yt by @SyncsLuca98 in https://github.com/AstraeLabs/VibraVid/pull/773
New Contributors
- @Omixxx made their first contribution in https://github.com/AstraeLabs/VibraVid/pull/761
- @Syncs-Luca98 made their first contribution in https://github.com/AstraeLabs/VibraVid/pull/763
- @username77 made their first contribution in https://github.com/AstraeLabs/VibraVid/pull/765
- @SyncsLuca98 made their first contribution in https://github.com/AstraeLabs/VibraVid/pull/773
Full Changelog: https://github.com/AstraeLabs/VibraVid/compare/v1.4.6...v1.4.7
- v1.4.62026-10-09 · 2026-10-09 15:38 UTC
查看更新说明
Full Changelog: https://github.com/AstraeLabs/VibraVid/compare/v1.4.5...v1.4.6
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
VibraVid
Quick 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! ⭐