# 快速上手

# 我所支持的 url

嘛~我也是比较挑剔的,目前我只支持以下几种视频 url

  • 投稿视频主页:
    • https://www.bilibili.com/video/avxxxxxx 嘛,这种 av 号的我会支持
    • https://b23.tv/avxxxxxx 短链接也可以考虑
    • https://www.bilibili.com/video/BVxxxxxx 最新的 bv 号也不错
    • https://b23.tv/BVxxxxxx 当然,它的短链接也可以
  • 番剧视频主页:
    • https://www.bilibili.com/bangumi/media/mdxxxxxx 番剧的主页当然可以
    • https://www.bilibili.com/bangumi/play/ssxxxxxx 番剧的播放页(ss 号的)也可以啦
    • https://b23.tv/ssxxxxxx 还有它的短链接
    • https://www.bilibili.com/bangumi/play/epxxxxxx 番剧的播放页(ep 号的)也是可以哒
    • https://b23.tv/epxxxxxx 当然也包括它的短链接啦

# 我的解释器:Python 3.9+

为了能够正常与你交流,你需要先安装 Python 前辈,当然一定要是 3.9 以上的版本,不然她可能也不知道我在说什么。

如果你是 Windows,请自行去 Python 官网 (opens new window)下载并安装,安装时记得要勾选「Add to PATH」选项,不然可能需要你手动添加到环境变量。

macOS 及 Linux 发行版一般都自带 python 环境,但要注意版本。

# 我的依赖:FFmpeg

由于 B 站给我的视频大多是需要合并的,所以我需要 FFmpeg 小可爱的帮助,你需要事先把她安装到你的电脑上~

如果你所使用的操作系统是 Windows,操作有些些麻烦,你需要手动下载 (opens new window)她,并将她放到你的环境变量中~

详细操作

打开下载链接后,在 「Get packages & executable files」 部分选择 Windows 徽标,在 「Windows EXE Files」 下找到 「Windows builds by BtbN」 并点击,会跳转到一个 GitHub Releases 页面,在 「Latest release」 里就能看到最新的构建版本了~

下载后解压,并随便放到一个安全的地方,然后在文件夹中找到 ffmpeg.exe,复制其所在文件夹路径。

右击「此电脑」,选择属性,在其中找到「高级系统设置」 → 「环境变量」,双击 PATH,在其中添加刚刚复制的路径(非 Win10 系统操作略有差异,请自行查阅「环境变量设置」的方法)。

保存保存,完事啦~~~

当然,如果你使用的是 macOS 或者 Linux 发行版的话,直接使用自己的包管理器就能一键完成该过程。

示例

比如 macOS 可以使用

brew install ffmpeg

Ubuntu 可以使用

apt install ffmpeg

Manjaro 等 Arch 系可以使用

pacman -S ffmpeg

大多都很简单的,其他就不一一列举啦~

此时,你可以在终端上使用 ffmpeg -version 命令来测试安装是否正确,只要显示的不是 Command not found 之类的提示就说明……成功啦~~~

# 召唤 𝓫𝓲𝓵𝓲𝓵𝓲

是时候闪亮登场啦,你可以通过以下两种方式中任意一种方式来召唤我~

# 通过 pip 复制我的镜像

由于我已经在 PyPI 上放置了自己的一份镜像,因此你可以通过 pip 来把那份镜像 copy 到自己电脑上

pip install bilili

# 通过 git 复制我的本体

如果你想见到我的最新版本体,那么你需要从 github 上将我 clone 下来

git clone git@github.com:yutto-dev/bilili.git
cd bilili/
pip install .

无论通过哪种方式安装,此时直接使用 bilili -v 命令都应该不再是 Command not found 之类的提示啦。

# 开始工作

一切准备就绪,请为我分配任务吧~

当然你只可以指派我可以完成的任务,也就是我所支持的 url 格式

我的工作指派方式非常简单

bilili <url>

当然这里的 <url> 需要用前面所说的 url 来替换。

示例

比如下载我的 演示视频 (opens new window)只需要

bilili https://www.bilibili.com/video/BV1vZ4y1M7mQ

下载番剧《关于我转生变成史莱姆这档事》 (opens new window)只需要

bilili https://www.bilibili.com/bangumi/media/md139252/

如果一切配置正确,此时我应该会正常工作咯。

当然,如果你想了解我的更多功能,请查阅参数使用部分。