【脚本】Emby-scanner媒体库重复检测工具，可联动删除网盘内文件

Emby媒体库重复检测工具 v2.0

                               
登录/注册后可看大图

一个简单易用、零依赖的 Emby 媒体库重复内容检测与清理工具，专为解决“同大异名”重复文件设计。
✨ 核心特性 (v2.0 Ultimate)

• 🎯 纯体积去重 (Size-Only)：完全忽略 TMDB ID 和文件名，仅基于**文件体积（精确到字节）**识别重复。完美解决同一视频文件因命名不同（如 Movie.mkv 和 Movie (1).mkv）导致的重复占用。
• 💾 深度删除 (User Session)：支持模拟 Emby 管理员登录，通过 API 触发删除操作，能够联动 Nastools/MoviePilot 等工具物理删除源文件。
• 🛡️ 安全熔断机制：内置 ID 碰撞检测，防止因 Emby 跨库合并条目导致的误删（“连坐”）风险。
• ✋ 手动精选模式：告别自动全删，提供交互式列表，由您亲自勾选要删除的副本，保留最佳版本。
• 🖥️ 仪表盘界面：全新的 Dashboard 风格终端 UI，实时显示各媒体库容量与冗余空间。
• 🔧 零依赖架构：移除 requests 库依赖，使用原生 urllib，无需安装 pip 包，开箱即用。
• 📂 路径防呆：数据强制保存至用户家目录 (~/emby_scanner_data)，解决管道运行时的路径权限问题。
• 🧐缺集检测逻辑：遍历剧集库 -> 检查每一季 -> 基于现有最大集数检测中间的空缺（例如有第1、3集，报告缺失第2集）
  

🚀 快速开始

单行命令运行（推荐）

这是最快、最稳定的启动方式。脚本会自动在您的家目录下创建数据文件夹。

1. # 适用于所有 Linux 发行版 / macOS
   
2. python3 -u <(curl -sL https://raw.githubusercontent.com/huanhq99/emby-scanner/main/emby_scanner.py)

复制代码

❓ 常见问题

Q: 为什么扫描剧集库时显示容量为 0 B？A: 旧版本只扫描了“剧集”层级。v2.0 Ultimate 已修复此问题，会自动深入扫描到“单集 (Episode)”层级，准确计算容量。
Q: “登录删除”安全吗？会不会盗号？A: 绝对安全。

• 您的密码仅在运行时用于获取一次性 Access Token，不会被保存到任何文件。
• 脚本是开源的，您可以随时审查代码逻辑。
  

Q: 为什么我有两个文件体积一样，但脚本没扫出来？A: 脚本执行的是字节级对比。如果文件大小差 1 个字节（例如元数据不同），也会被视为不同文件。这是为了防止误删不同版本的影片（如 1080P 和 4K 版本体积通常不同）。
Q: 连接服务器失败？A: 请检查：

• 地址是否包含 http:// 或 https://。
• API 密钥是否有权限。
• 如果是 Docker 容器，请确认网络互通。
  

🤝 贡献与反馈

如果您遇到问题或有改进建议：

• 在 GitHub Issues 提交反馈，请附上报错截图。
• 欢迎 Fork 本仓库并提交 Pull Request。
  

📝 更新日志

v2.1 (当前版本) 。

• 功能特性：新增了“智能缺集检测”的描述。
• 使用指南：增加了关于缺集检查的操作说明。
• 更新日志：添加了 v2.1 的更新记录。
  
  

v2.0 Ultimate (当前版本)

• 🔄 重构：回归 v2.x 版本号体系，确立终极稳定版。
• ✨ 新增：用户模拟登录删除功能，支持联动 Nastools/MP。
• ✨ 新增：手动精选删除模式，支持多选。
• 🛡️ 安全：增加 ID 熔断保护，防止 Emby 跨库合并条目被误删。
• 💄 UI：全新的仪表盘风格界面。
  

v1.0

• 基础扫描功能。
• 基于 TMDB ID 的查重。
  

📄 许可证

MIT License
🔗 相关链接

• GitHub 仓库
• Emby 官网
  

注意: 本工具仅供个人学习与媒体库维护使用，请在执行删除操作前务必确认文件列表。

学习了~