# 喵帕斯解析器 (nyanpasu)

喵帕斯解析器是一个 BiliBili 番剧视频和弹幕元数据的解析脚本，可以根据链接自动下载和解析视频和弹幕元数据，并创建下载列表。

## 安装

此脚本没有使用任何平台特定的代码，应当可以适用于所有主流操作系统，但是它只在 Linux 下测试过。

你需要首先安装 Node.JS 以运行此脚本。你可以从 Github Release 下载到一个压缩后脚本，包含脚本代码及其 NPM 依赖。该脚本包含正确的“井号注释”（shebang），可以直接赋予可执行权限并执行。你可以考虑将其复制到 PATH 目录下（例如 `~/.local/bin` 或者 `/usr/local/bin`）以便于使用。

你可能希望安装 [yt-dlp](https://github.com/yt-dlp/yt-dlp) 及其依赖 [ffmpeg](https://ffmpeg.org/) 以便于下载视频。你可能还希望使用 [Tmux](https://github.com/tmux/tmux) 或者 [GNU Screen](https://www.gnu.org/software/screen/) 以防止因为关闭终端而导致下载中断。

## 构建

你也可以手工构建并打包此项目，首先你需要安装 Node.JS 和 npm，并下载本仓库，然后执行：

```
npm install
npm run build
```

即可在 `dist/nyanpasu.mjs` 找到输出。

请注意，此脚本的打包脚本 `build.sh` 不适用于 Windows（依赖于 `/bin/sh`），但是可以应当很容易的适配到 Windows（如果对此需要帮助，请随时提交一个 Issue）。

## 使用方法

首先，你需要得到番剧的一集的链接，并作为命令行参数传入脚本。以下以 [幸运星](https://www.bilibili.com/bangumi/play/ep35595) 为例，切换到一个合适的空目录并执行：

```sh
nyanpasu.mjs https://www.bilibili.com/bangumi/play/ep35595
```

得到类似于以下的输出：

```
Downloading descriptor info
Title: 幸运星
Count: 25 episodes
 * Episode 1: 狂奔的女人
 * Episode 2: 努力与结果
 * Episode 3: 形形色色的人们
 * Episode 4: 干劲的问题
 * Episode 5: 神射手
 * Episode 6: 夏天的例行节目
 * Episode 7: 印象
 * Episode 8: 即使不是我也很旺盛喔
 * Episode 9: 这种感觉
 * Episode 10: 愿望
 * Episode 11: 过平安夜的各种方法
 * Episode 12: 一起去祭典吧
 * Episode 13: 美味的日子
 * Episode 14: 同一个屋檐下
 * Episode 15: 一时变不过来
 * Episode 16: 循环
 * Episode 17: 名正言顺
 * Episode 18: 十个人十个样
 * Episode 19: 二次元的本质
 * Episode 20: 渡过夏天的方法
 * Episode 21: 潘朵拉的盒子
 * Episode 22: 在这里的彼方
 * Episode 23: 微妙的那条线
 * Episode 24: 未定
 * Episode 25: OVA
Command hint: yt-dlp -a vlist.txt -o "%(autonumber)s.%(ext)s" -f mp4
```

并生成四个文件：

```plain
cache.json  descriptor.xml  download-danmu.sh  vlist.txt
```

其中 `cache.json` 是番剧元数据的缓存，`descriptor.xml` 是简化后的番剧元数据，可供人阅读或其他软件解析。`download-danmu.sh` 是用于下载弹幕数据和番剧封面图的脚本（内部使用 `wget`）。`vlist.txt` 是各集视频的链接，你可以进一步使用如下命令下载弹幕数据和番剧封面图：

```sh
./download-danmu.sh
```

如果你安装了 [yt-dlp](https://github.com/yt-dlp/yt-dlp)，你进一步可以根据 `vlist.txt` 中的链接下载各集视频：

```
yt-dlp -a vlist.txt -o "%(autonumber)s.%(ext)s" -f mp4
```

根据需要，你可能需要添加 `--cookies`、`--cookies-from-browser`、`--abort-on-error` 等命令选项，注意可能无法下载付费视频和地区限制视频，可能会报错。更多信息请参考 [yt-dlp](https://github.com/yt-dlp/yt-dlp) 的文档。

你可以通过 `--help` 选项或阅读 `src/index.mjs` 源代码以查看更多命令行选项。

## 社区

我们期待来自社区的贡献。如果您遇到了错误，请随时提出问题。还有许多可以添加的功能。如果您实现了任何增强功能，欢迎打开一个拉取请求。

## 声明

请注意，本项目不代表上海宽娱数码科技有限公司或番剧版权方的意见，本项目按照“按其原样”的原则提供，不提供任何附带保证，使用者需承担可能的风险。

本项目完全开源，且没有任何代码加密操作，如有疑虑请自行审查代码或停止使用相关文件。对于使用本项目产生的额外问题，如账户封禁或被盗等，维护者不对此负责，请谨慎使用。

请尊重数字版权，请勿二次分发使用此脚本（以及使用此脚本生成的脚本）得到文件。

## 版权

本项目使用 GNU 通用公共许可证 v2.0 许可证。根据该许可证，您有权复制、修改、分发本项目的源代码和衍生作品。然而，您必须遵守许可证中规定的条件，包括在您的衍生作品中保留原始版权信息和许可证，并在分发时提供许可证的副本。此外，您还需要确保任何引用或使用本项目的内容的用户也能够获得许可证的副本。请注意，GNU 通用公共许可证 v2.0 许可证不允许您将本项目的代码用于专有软件，因此任何基于本项目的衍生作品也必须使用GNU 通用公共许可证 v2.0 许可证发布。详细信息请见 `LICENSE` 文件。