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. 目录导航

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 文件。

🆘 支持

如遇到问题，请检查：

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

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

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