VibraVid

AstraeLabsGPL-3.0活跃维护

支持电影、剧集、动漫、专辑和歌曲的下载工具,能处理 DASH、HLS、ISM 等流媒体格式及 MP4 文件,适合离线保存音视频内容。

Downloader for Movie, Series, Anime, Album, Song + DASH/HLS/ISM/MP4.

v1.5.0发布于 2026-11-09 07:39 UTC1,272star +3 / 7 天167fork同步于 2026-11-10 17:51 UTC

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/AstraeLabs/VibraVid.git
cd VibraVid
pip install -r requirements.txt
python manual.py
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

下载电影、剧集、动漫、专辑和歌曲,支持 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)部署

容易踩的坑

需先按 requirements.txt 安装 Python 依赖才能运行;部分服务需登录认证,参见 Login Guide;DRM 相关内容 README 声明不提供解密工具或密钥

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v1.5.0
  1. v1.5.0最新正式版2026-11-09 · 2026-11-09 07:39 UTC

    What's Changed

    Full Changelog: https://github.com/AstraeLabs/VibraVid/compare/v1.4.9...v1.5.0

  2. v1.4.92026-10-30 · 2026-10-30 13:19 UTC
    查看更新说明
  3. v1.4.82026-10-23 · 2026-10-23 08:51 UTC
    查看更新说明

    Changelog

    Migration and breaking changes

    • TOML configuration: Conf/config.json and Conf/login.json are replaced by config.toml and login.toml.
    • extra_args → args: a service's persistent CLI options now live under the args key of its login.toml section.
    • 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 in wvd/ and prd/; .wvd/.prd files left in the old flat directory are still found, executables are not.
    • --down-json replaced by --import, fed by files created with the new --export.
    • --drm no longer accepts auto: valid values are widevine/playready (aliases wv/pr).
    • Removed DEFAULT.debug_track_json, REQUESTS.bypasser_url and DRM.prefer_remote_cdm.
    • Removed the built-in services 7movies, discovery, dmax, foodnetwork, homegardentv, nove, monochrome and realtime (merged into aurora).
    • Removed the Amazon provider, the Docker bypasser sidecar and the --amazon-music-login / --amazon-music-logout flags.

    Core

    Downloader and pipeline
    • New --export / --import flow: resolves tracks and keys and writes a JSON file (default .cache/export/<site>_<type>_<title>.json).
    • New DownloadFailed exception: 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 → service cdm in login.toml → [DRM] cdm in config.toml.
    • Per-quality rules (min_height / max_height), with the CDM chosen based on the highest selected video resolution; search performs automatic file discovery and default delegates 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-list on 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_auto filter also applied to streams not explicitly flagged as DV.

    Services

    Removed
    • discovery, dmax, foodnetwork, homegardentv, nove
    • realtime (renamed and expanded into aurora)

    CLI

    • --export [FILE] and --import FILE instead 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.toml credential management, with "configured / needs setup" status and notes for CDM, args and cookies.
    • Refresh of external imp_service services from the TUI too.
    • ServiceExit: a service's sys.exit() becomes an error message instead of closing the app.

    GUI

    • Built-in config.toml and login.toml editor with server-side TOML validation and .backup file.
    • 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/prd layout; configurable CDM directories.
    • Docker: removed the bypasser sidecar, updated paths to config.toml, added VIBRAVID_HIDDEN_SITES.
    • Telegram bot u
  4. v1.4.72026-10-16 · 2026-10-16 13:29 UTC
    查看更新说明

    What's Changed

    New Contributors

    Full Changelog: https://github.com/AstraeLabs/VibraVid/compare/v1.4.6...v1.4.7

  5. v1.4.62026-10-09 · 2026-10-09 15:38 UTC
    查看更新说明

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    VibraVid

    Windows macOS Linux


    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
    ⚙️ Configurationconfig.toml reference — DEFAULT, OUTPUT, DOWNLOAD (stream selection filters), CODEC, PROCESS, REQUESTS, DRM
    💻 CLI UsageSearch, series selection, year filter, track overrides, proxy, direct URL download, download queue
    🌐 Web GUIDjango-based browser interface
    ⌨️ TUITerminal user interface (Textual)
    🤖 Telegram BotTrigger downloads from chat
    🔗 ARR IntegrationSeerr/Jellyseerr, Sonarr, Radarr automation
    🪝 Hook SystemRun custom scripts on download lifecycle events
    🐳 DockerCompose, custom ports/paths, private network deployment
    🖥️ NAS DeploymentSynology, TrueNAS, Unraid
    🔑 Login GuideAuthentication 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! ⭐