安装须知

下方提供额外文档！

将根文件夹设置为 /media/data/comics

---

Kapowarr 是一款用于构建和管理漫画书库的软件，属于 *arr 系列软件的一员。

工作原理

Kapowarr 允许您构建一个数字漫画库。您可以添加漫画系列，将其映射到文件夹并开始管理！下载该系列的期刊（或 TPB），重命名并移动它们。整个过程是自动化的，并且所有设置都可以在配置中自定义。

每天，系统都会检查每个系列是否有新期刊发布，如果有，它将立即被下载并添加到您的库中。

功能特点

• 将您现有的库直接导入 Kapowarr
• 获取库中系列和期刊的大量元数据
• 运行"搜索已监控"功能，一键下载整个系列
• 或使用"手动搜索"来自行决定下载内容
• 支持直接从服务器下载，或通过 MediaFire 和 Mega 下载
• 下载的文件会自动移动到您指定的位置，并按您想要的格式重命名
• 压缩文件可以在下载后自动解压，其内容会被重命名，也可以一键完成此操作
• 熟悉的 *arr 系列软件用户界面

安装、支持与文档

• 有关如何安装 Kapowarr 的说明，请参阅安装文档。
• 如需支持，可加入 Discord 服务器 或 提交问题。
• 所有文档请参见文档中心。

截图

---

文件夹信息

根文件夹	容器文件夹
/runtipi/app-data/kapowarr/data/kapowarr-db	/app/db
/runtipi/media/downloads/kapowarr	/app/temp_downloads
/runtipi/media	/media

---

文档

身份验证

您可能需要设置密码以限制对 Web 界面（和 API）的访问。设置密码是可选的。可以在 设置 -> 常规 -> 安全 -> 登录密码 处设置密码。别忘了保存。此后，需要输入密码才能访问 Web 界面（和 API）。如果您想禁用密码，请将该设置设为空值并保存。

ComicVine API 密钥

Kapowarr 使用 ComicVine 作为其元数据源。为了从 ComicVine 获取元数据，Kapowarr 需要访问其 API，这需要一个 API 密钥。

1. 访问 ComicVine 的 API 页面。
2. 如果您还没有 ComicVine 的免费账户，请注册，登录后重新访问该页面。
3. 您将看到您的 ComicVine API 密钥，它长 40 个字符，包含字母 a-f 和数字 0-9（例如 da39a3ee5e6b4b0d3255bfef95601890afd80709）。
4. 复制该 API 密钥，并在 Web 界面的 设置 -> 常规 -> Comic Vine API -> Comic Vine API 密钥 处输入。别忘了保存。

关于速率限制的文档页面提供了有关 ComicVine API 速率限制处理的信息。

根文件夹

根文件夹是 Kapowarr 工作的基础文件夹。所有内容都放在这些文件夹中。添加系列（或编辑系列）时，您需要选择将该系列的所有内容放入哪个根文件夹。Kapowarr 永远不会触及根文件夹之外的任何文件（下载文件夹除外）。您可能有多个根文件夹，原因包括：将漫画存储在多个驱动器上，或希望对某些系列设置不同的访问权限等。

可以在 设置 -> 媒体管理 -> 根文件夹 处添加根文件夹。注意：如果您使用 Docker 运行 Kapowarr 并遵循了安装说明中的示例，则应在此处输入 /media/data/comics

下载

Kapowarr 最大的功能之一是能够下载漫画。设置 -> 下载 部分包含了所有与下载相关的设置。

下载文件夹¶

下载文件夹（设置 -> 下载 -> 下载位置 -> 直接下载临时文件夹）是所有文件在被移动到最终目的地之前下载到的位置。如果您使用 Docker 运行 Kapowarr，请将此设置保留为默认值 /app/temp_downloads，并改为更改 Docker 命令中 /path/to/download_folder 的值。如果您是手动安装，可以将此值更改为您想要的任何路径。允许它在您的根文件夹之外。

服务偏好

Kapowarr 能够直接从服务器下载，也能从 MediaFire 和 Mega 等服务下载。像 getcomics.org 这样的网站通过多种服务提供相同的下载（指向同一文件的不同服务下载链接）。此设置决定了您对每种服务的偏好。如果同一下载提供了多种服务，Kapowarr 将使用此偏好列表来决定选择哪种服务（如果首选服务的链接无效，Kapowarr 将按顺序回退到其他选项）。如果您拥有其中一项服务的账户（参见 凭据 设置），您可能希望将其置于首位，以便 Kapowarr 利用该账户提供的额外功能（额外带宽、更高的速率限制等）。

凭据

Kapowarr 能够从 MediaFire 和 Mega 等服务下载。这些服务会限制您每天可以下载的量或下载速度。这些服务的（付费）账户通常提供更高的限制。Kapowarr 可以利用这些账户提供的额外功能。在凭据部分，您可以添加账户凭据，Kapowarr 将在下载时使用这些凭据，以利用额外功能。

构建库

现在您可以开始构建库了。在 系列 -> 添加系列 处，您可以搜索系列并将其添加到您的库中。添加后，系统会在选定的根文件夹中自动为该系列创建一个文件夹（参见 设置 -> 媒体管理 -> 文件命名 -> 系列文件夹命名）。然后，您可以开始为该系列下载内容，所有文件都将放入此系列文件夹中。文件的命名遵循设置中设定的格式（参见 设置 -> 媒体管理 -> 文件命名）。

解压缩

Kapowarr 内置了解压缩功能。这意味着它可以提取 zip 文件，过滤内容以找到实际需要的文件，删除其他文件，将文件移动到正确的位置并正确命名，删除 zip 文件夹并删除 zip 文件。可以通过启用 设置 -> 媒体管理 -> 解压缩 -> 解压下载文件 来自动为所有下载的 zip 文件执行此操作。也可以在查看系列时按"解压"按钮，为该系列的所有 zip 文件执行解压缩。

目前将现有库导入 Kapowarr 的过程还不太流畅（Radarr/Sonarr 中的"库导入"功能尚未在 Kapowarr 中实现）。建议的与当前库配合使用的方式如下：

1. 在 Kapowarr 中添加一个系列。
2. 将该系列的内容从当前文件夹移动到 Kapowarr 生成和创建的系列文件夹中。
3. 在 Kapowarr 中转到该系列，点击"刷新并扫描"按钮。Kapowarr 将扫描系列文件夹并导入所有文件。
4. 刷新 Web 界面。
5. （可选）点击"预览重命名"，Kapowarr 将立即根据设置中的文件命名格式为文件建议新的命名。
6. 对当前库中的所有系列重复此过程。

有计划添加对自定义系列文件夹的支持，并添加"库导入"功能，以使导入现有库的过程更加容易。