「工具」Openlist 网盘剧集文件批量重命名工具

[xiaobili]

OpenList 交互式剧集重命名工具

一个基于 Python 的交互式工具，用于连接 OpenList 服务并批量重命名剧集文件。该工具提供了直观的命令行界面，支持多种重命名模式，让剧集整理变得简单高效。

项目地址

https://github.com/xiaobili/openlist_episode_rename

🚀 功能特性

核心功能

• 目录浏览 - 交互式导航 OpenList 文件系统
• 批量重命名 - 支持多种重命名模式的批量操作
• 剧集信息识别 - 自动从文件名中提取剧集信息
• 多模式重命名 - 智能识别、手动输入、统一样式等多种方式

重命名模式

• 智能重命名 - 自动识别文件名中的剧集信息并标准化
• 手动重命名 - 逐个为文件指定新名称
• 统一样式 - 为所有文件使用相同模式，自动递增集数
• 正则替换 - 使用正则表达式进行高级重命名

用户体验

• Rich 界面 - 提供美观的终端界面（ rich 版本）
• 进度指示 - 操作过程中的可视化进度条
• 确认机制 - 重命名前预览和确认
• 错误处理 - 完善的异常处理和错误提示

新增功能

• Token 持久化 - 登录后将 JWT 令牌保存到本地文件 $EPISODE_PATH/token，实现免登录访问
• 自动登录恢复 - 启动时自动检测并使用有效的本地令牌，无需重复输入凭据
• 配置文件管理 - 将 OpenList 服务地址等配置信息保存到用户主目录下的 .episoderenamer_config.ini 文件中

📋 系统要求

• Python 3.7+
• 网络连接到 OpenList 服务

🔧 依赖包

pip install requests rich

🛠️ 安装使用

1. 克隆或下载项目

# 下载项目文件

2. 安装依赖

pip install requests rich

3. 运行程序

# Rich 美化版（推荐）
python interactive_episode_renamer_with_rich.py

# 基础版本
python interactive_episode_renamer.py

⚙️ 配置参数

连接设置

• 服务地址: OpenList 服务的 URL （如 http://192.168.1.1:5244）
• 用户名: OpenList 账户用户名
• 密码: OpenList 账户密码

Token 持久化设置

• 令牌路径: 系统环境变量 $EPISODE_PATH，令牌文件名为 token
• 默认路径: 如果未设置 $EPISODE_PATH，令牌将保存到 /tmp/token

配置文件设置

• 配置文件路径: 用户主目录下的 .episoderenamer_config.ini
• 默认地址: 配置文件中保存的默认 OpenList 服务地址
• 自动加载: 启动时自动从配置文件加载默认地址

支持的视频格式

.mp4, .mkv, .avi, .mov, .wmv, .flv, .webm, .m4v, .mpg, .mpeg, .ts, .m2ts, .vob, .iso

📖 使用指南

1. 登录验证

• 启动程序后，系统会首先尝试从本地文件加载令牌
• 如果令牌存在且有效，将跳过登录步骤
• 如果令牌不存在或已过期，需要输入 OpenList 服务地址、用户名和密码

2. 配置管理

• 首次运行时，需要输入 OpenList 服务地址
• 地址将自动保存到配置文件中
• 后续运行时，默认地址将从配置文件加载

3. 目录导航

• 选择数字进入子目录
• 0 键返回上级目录
• 查看当前目录的文件和子目录

4. 重命名操作

• 选择视频文件进行批量重命名
• 选择重命名模式：
  • 智能重命名: 自动解析剧集信息
  • 手动重命名: 逐一指定新名称
  • 统一样式: 统一格式，递增集数

5. 命名模式示例

• {title}.S{season}E{episode:02d} → 权力的游戏.S01E01.mp4
• Season_{season}_Episode_{episode:02d}_{title} → Season_01_Episode_01_权力的游戏.mp4

🔍 技术架构

主要组件

• InteractiveEpisodeRenamer - 核心重命名类
• API 集成 - 与 OpenList API 通信
• 文件系统操作 - 目录浏览和文件重命名
• Token 管理 - 本地令牌持久化和自动加载
• 配置管理 - 本地配置文件读写和管理

API 接口

• /api/auth/login - 用户认证
• /api/fs/list - 获取目录内容
• /api/fs/batch_rename - 批量重命名

🤝 贡献指南

欢迎提交 Issue 和 Pull Request 来改进这个项目！

📄 许可证

遵循 MIT 许可证。详情请参阅 LICENSE 文件。

🆘 支持

如遇到问题，请检查：

1. OpenList 服务是否正常运行
2. 网络连接是否稳定
3. 用户名和密码是否正确
4. API 端点是否可用
5. $EPISODE_PATH 环境变量是否正确设置（用于令牌持久化）
6. 配置文件是否存在且格式正确

---

享受整洁有序的剧集收藏！