V2EX = way to explore

V2EX 是一个关于分享和探索的地方

已注册用户请登录

爱意满满的作品展示区。

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 批量重命名剧集文件

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