非官方的命令行工具和库，用于使用 catbox.moe 的 API。

有关库文档，请参阅 Github Pages.

安装

请参阅 GitHub 发布页面 以获取命令行工具的最新 Linux 和 Windows 构建。

您可以使用 Cargo 编译和安装命令行工具

cargo install catbox

要在您的项目中使用库，请将仓库添加到您的 Cargo.toml

[dependencies]
catbox = "*"

用法

使用 catbox --help 查看用法。

Catbox 具有以下命令

• upload: 将文件或 URL 上传到 Catbox。
• delete: 删除文件
• album: 专辑命令
• litter: 将临时文件上传到 Litterbox。

如果未提供 upload 的用户哈希，则文件将以匿名方式上传。删除文件需要提供用户哈希。

album 子命令有额外的子命令

• create: 创建新专辑
• delete: 删除专辑
• edit: 编辑专辑
• add: 将文件添加到专辑
• remove: 从专辑中删除文件

除 create 之外的所有专辑命令都需要用户哈希。

您可以在任何命令上使用 --help 查看有关其用法的详细信息。

基本 upload 命令可以与本地文件和托管在其他地方的文件的 URL 一起使用。

某些命令需要账户哈希才能正常工作。这可以通过使用 --user 参数或设置 CATBOX_USER_HASH 环境变量来提供。显式提供的参数将优先于环境变量。如果设置了环境变量，即使它不是必需的，也会使用它。

所有命令都打印来自服务器的响应，通常是创建的文件或专辑的链接。

有关API的更多信息，请参阅https://catbox.moe/tools.php，有关允许的文件类型和内容，请参阅https://catbox.moe/faq.php。

请考虑通过https://www.patreon.com/catbox捐赠，以帮助支付服务器费用。

示例

上传文件

catbox upload cute_picture.png

上传多个文件

catbox upload *.jpg  # Upload all jpg files
catbox upload image.png file.txt  # Upload image.png and file.txt

删除文件

catbox delete abc123.jpg --user 1234567890123456789012345
catbox delete https://files.catbox.moe/123456.png  # Or just 123456.png

创建相册

catbox album create --title 'My album' --desc 'An excellent album' abc123.jpg def456.png

如果环境变量中存在CATBOX_USER_HASH，则不需要用户参数。

将文件上传到Litterbox，保存3天

catbox litter --time 72h homework.zip