datashaman/putio-automator

Put.IO自动化工具

一套用于管理Put.IO上种子、传输和文件的命令工具。

可配置Sickrage使用种子黑洞文件夹，同时配置本应用监控该文件夹，并将文件下载到Sickrage用于后处理的同一目录。

目录

• 安装
• 配置
• 常规使用
  • 种子管理
  • 文件管理
  • 传输管理
  • 数据库管理
• 高级用法
  • Docker部署

安装

推荐为当前用户本地安装putio-automator包：

pip install --user putio-automator

这会在$HOME/.local/bin目录下安装putio命令行工具。确保该路径在系统环境变量中：

echo 'PATH=$HOME/.local/bin:$PATH' >> .profile # 或.bashrc、.zshrc，视系统而定

若需为所有用户安装（不推荐）：

sudo -H pip install putio-automator

工具会安装到/usr/local/bin或类似目录，通常已在环境变量中。

配置

推荐为当前用户初始化基础配置：

putio config init

若需为所有用户初始化（不推荐）：

putio config init --site

该命令会交互式提示文件存储路径及Put.IO的OAuth令牌。

获取OAuth令牌需在Put.IO上注册应用，然后复制密钥图标下的OAuth令牌。

注意：输入的目录需具备全局写入权限（后续会优化权限处理）。

验证连接是否正常：

putio account info

应显示包含账户信息的JSON数据包，若未显示请检查OAuth令牌是否正确。

查看当前配置以调试问题：

putio config show

常规使用

种子管理

监控配置目录中的种子并添加到Put.IO：

putio torrents watch [-a] [-p PARENT_ID]

• -a, --add_existing：先添加已存在的种子
• -p PARENT_ID, --parent_id PARENT_ID：添加文件的父文件夹ID

添加已存在的种子到Put.IO：

putio torrents add [-p PARENT_ID]

• -p PARENT_ID：添加文件的父文件夹ID

文件管理

列出Put.IO上的文件：

putio files list [-p PARENT_ID]

• -p PARENT_ID：要列出文件的父文件夹ID

将Put.IO上的文件下载到配置的下载目录：

putio files download [-l LIMIT] [-c CHUNK_SIZE] [-p PARENT_ID] [-f FOLDER]

• -l LIMIT：单次下载的最大文件数
• -c CHUNK_SIZE：默认256kb
• -p PARENT_ID：要下载文件的父文件夹ID
• -f FOLDER：下载目录中的目标子文件夹

传输管理

列出Put.IO上的传输任务：

putio transfers list

按状态取消传输：

putio transfers cancel_by_status statuses

• statuses：逗号分隔的状态列表

取消已完成的传输：

putio transfers cancel_completed

取消正在做种的传输：

putio transfers cancel_seeding

清理已完成的传输：

putio transfers clean

整理传输任务（取消做种和已完成的传输，然后清理）：

putio transfers groom

数据库管理

应用使用SQLite数据库记录下载记录，避免重复下载。以下命令可清除包含特定子串的文件记录，以便重新下载：

putio db forget name

• name：文件名中的子串

高级用法

Docker部署

拉取最新Docker镜像：

putio docker pull

运行容器以按可选计划管理下载：

putio docker run [-s START_HOUR] [-e END_HOUR] [-c CHECK_DOWNLOADS_EVERY] [-t TAG]

• -s START_HOUR：开始下载的小时，默认0
• -e END_HOUR：结束下载的小时，默认24（等同于0）
• -c CHECK_DOWNLOADS_EVERY：检查下载的间隔（分钟），默认15
• -t TAG：镜像标签，默认datashaman/putio-automator

容器会使用配置的目录监控种子并下载文件。可通过http://localhost:9001访问supervisor控制台。