Skip to content
This repository has been archived by the owner on Oct 26, 2024. It is now read-only.
/ bilili Public archive

🍻 bilibili video (including bangumi) and danmaku downloader | B站视频(含番剧)、弹幕下载器

License

Notifications You must be signed in to change notification settings

yutto-dev/bilili

Repository files navigation

𝓫𝓲𝓵𝓲𝓵𝓲

Bilibili PyPI - Python Version pypi PyPI - Downloads Build Status LICENSE Gitmoji

🍻 𝓫𝓲𝓵𝓲𝓵𝓲,一个可以帮你快速下载 B 站投稿视频以及番剧视频的 CLI~~~

文档戳这里啦 → bilili の可愛い自己紹介

Warning

由于 B 站近期 API 的变动较大,导致 bilili 部分功能无法正常使用,相关问题已在 v2 版本(yutto)中修复,限于个人精力,无法同时维护两个版本,所以建议大家尽快迁移至 v2 版本,感谢大家一直以来对 bilili 的支持~

特性

  • 支持投稿视频(也即原 AV 号视频)和番剧下载
  • 多线程 + 分块下载,总之就是很快啦
  • 断点续传,即便一次没下完也可以接着下载
  • 弹幕支持,自动下载弹幕并可转换为 ASS 弹幕

快速开始

bilili 可以从以下两种视频主页获取视频

  • 投稿视频主页:
    • https://www.bilibili.com/video/avxxxxxx
    • https://b23.tv/avxxxxxx
    • https://www.bilibili.com/video/BVxxxxxx
    • https://b23.tv/BVxxxxxx
  • 番剧视频主页:
    • https://www.bilibili.com/bangumi/media/mdxxxxxx
    • https://www.bilibili.com/bangumi/play/ssxxxxxx
    • https://b23.tv/ssxxxxxx
    • https://www.bilibili.com/bangumi/play/epxxxxxx
    • https://b23.tv/epxxxxxx

安装 FFmpeg

由于大多数格式需要合并,所以 bilili 依赖于 FFmpeg,你需要事先安装好它

Windows 请手动下载并解压后,存放到任意文件夹下,之后将 ffmpeg.exe 所在文件夹添加到环境变量

而如果是 macOS 或者 Linux 发行版,这一步可以很方便地通过包管理器一键完成啦~

最后你可以通过直接在终端运行 ffmpeg -version 测试是否安装成功

安装 bilili

pip 安装

现在 bilili 支持通过 pip 一键安装

pip install bilili

源码安装

此外你还可以从 GitHub 上下载最新的源码进行安装

git clone [email protected]:yutto-dev/bilili.git
cd bilili/
pip install .

运行

你只需要这样就可以运行 bilili 啦~

bilili <url>

当然,你需要将 <url> 替换为前面的视频主页 url

参数

bilili 还支持很多参数,但参数使用方法等内容此处不作赘述,详情请访问文档

  • -t/--type 选择下载类型(flv or dash or mp4),默认为 dash 类型,注意该参数仅代表下载源格式,所有格式最后均会转为 mp4
  • -d/--dir 指定存储目录,默认为项目根目录
  • -q/--quality 指定清晰度,默认为 127(8K 超高清)
  • -n/--num-threads 指定最大下载线程数,默认为 16
  • -p/--episodes 选集,默认为 ^~$(全选)
  • -s/--with-section 同时下载附加剧集( PV、预告以及特别篇等专区内容)
  • -w/--overwrite 强制覆盖已下载视频
  • -c/--sess-data 传入 cookies 中的 SESSDATA
  • -y/--yes 跳过下载询问
  • --audio-quality 指定音频质量等级,默认为 30280(320kbps)
  • --playlist-type 指定播放列表类型,支持 dplm3u ,默认为 dpl,设置为 no 即不生成播放列表
  • --danmaku 指定弹幕类型,支持 xmlass,如果设置为 no 则不下载弹幕,默认为 xml 弹幕
  • --block-size 分块下载器的块大小,单位为 MB,默认为 128MB,设置为 0 时禁用分块下载
  • --abs-path 修改播放列表路径类型为绝对路径
  • --use-mirrors 启用从多个镜像下载功能
  • --disable-proxy 禁用系统代理
  • --no-color 不使用任何颜色
  • --debug 开启 debug 模式

参与贡献

请阅读 CONTRIBUTING.md