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.mp4Season_{season}_Episode_{episode:02d}_{title} → Season_01_Episode_01_权力的游戏.mp4
🔍 技术架构
主要组件
API 接口
/api/auth/login - 用户认证/api/fs/list - 获取目录内容/api/fs/batch_rename - 批量重命名
🤝 贡献指南
欢迎提交 Issue 和 Pull Request 来改进这个项目！
📄 许可证
遵循 MIT 许可证。详情请参阅 LICENSE 文件。
🆘 支持
如遇到问题，请检查：
- OpenList 服务是否正常运行
- 网络连接是否稳定
- 用户名和密码是否正确
- API 端点是否可用
$EPISODE_PATH 环境变量是否正确设置（用于令牌持久化）- 配置文件是否存在且格式正确
享受整洁有序的剧集收藏！
