项目概述
项目地址: https://gitcode.com/gh_mirrors/sy/syno-videoinfo-plugin Synology Video Info Plugin是一款专为群晖Video Station设计的第三方视频信息插件。该插件能够从多个影视数据库平台自动获取视频元数据，为您的媒体库添加丰富的影片信息。
核心功能特性
多数据源支持
插件内置了多个影视数据库的支持，包括豆瓣、TMDB、猫眼、时光网、Bangumi等主流平台。每个数据源都有专门的配置文件，确保数据获取的准确性和完整性。
零依赖架构
整个插件完全基于Python标准库实现，无需安装任何第三方依赖，保证了在不同群晖系统环境下的兼容性和稳定性。
可视化配置界面
插件提供了简洁易用的Web配置界面，用户可以通过浏览器访问http://[NAS_IP]:5125来进行个性化设置。
安装部署步骤
环境要求
- Python 3.6及以上版本
- Video Station 2.5.0+（DSM 6.0系统）
- Video Station 3.0.0+（DSM 7.0系统）
安装流程
- 克隆项目到本地：
git clone https://gitcode.com/gh_mirrors/sy/syno-videoinfo-plugin
- 打包插件文件：
python setup.py sdist --formats=zip
- 在Video Station中安装：
- 打开Video Station，进入"设置" > "视频信息插件"
- 点击"新增"，选择打包好的zip文件
- 确认安装完成
配置与使用
配置服务启动
安装完成后，配置服务会自动在端口5125上启动。您可以通过浏览器访问配置页面进行个性化设置。
命令行测试
使用以下命令测试插件功能：
python main.py --type movie --input "{\"title\":\"电影名称\"}" --limit 1 --loglevel debug
文件命名规范
为了确保插件能够正确识别视频文件，请遵循以下命名规则：
电影文件命名格式：
- 格式：电影名称 (发行年份).ext
- 示例：Avatar (2009).avi
电视剧文件命名格式：
- 格式：电视剧名称.SXX.EYY.ext（S表示季数，E表示集数）
- 示例：Gossip Girl.S03.E04.avi
项目架构解析
目录结构说明
项目根目录/
├── configserver/ # 配置服务模块
│ ├── server.py # 配置服务器
│ └── templates/ # 配置页面模板
├── scrapeflows/ # 数据抓取流程配置
├── scraper/ # 核心抓取引擎
├── main.py # 程序入口点
├── resolvers.conf # DNS解析器配置
└── setup.py # 安装打包脚本
核心模块功能
配置服务模块 (configserver/)
- 提供Web配置界面
- 管理插件设置
- 处理用户配置请求
数据抓取流程 (scrapeflows/)
- 包含各数据源的抓取配置
- 支持电影、电视剧、剧集等不同类型
- 可自定义抓取优先级和策略
抓取引擎 (scraper/)
- 实现核心抓取逻辑
- 提供错误处理和重试机制
- 支持多种数据格式输出
高级配置选项
解析器配置
resolvers.conf文件包含了DNS解析器的配置，支持多个公共DNS服务，确保网络请求的稳定性和安全性。
故障排除
常见问题解决
配置页面无法访问
- 确认配置服务已启动（端口5125）
- 检查防火墙设置
- 验证NAS IP地址
元数据获取失败
- 检查网络连接状态
- 验证文件命名格式
- 查看日志输出信息
服务重启方法
如果升级插件后配置页面没有更新，可通过以下步骤重启服务：
- 打开配置页面，点击右上角的"Exit"按钮关闭服务
- 返回Video Station，进入"设置" > "视频信息插件"
- 点击"测试连接"按钮重新启动服务
开发与扩展
自定义开发
开发者可以基于现有代码进行功能扩展：
- 添加新的数据源支持
- 修改抓取策略
- 优化数据处理流程
测试与验证
在开发过程中，使用提供的命令行工具进行功能测试，确保新功能的稳定性和兼容性。
使用建议
- 批量处理：建议在系统空闲时段进行批量元数据获取
- 网络环境：确保NAS具有良好的网络连接
- 文件管理：按照推荐格式命名视频文件
- 定期更新：关注项目更新，及时获取新功能和修复
通过本插件的使用，您可以为Synology Video Station添加更丰富的视频信息，提升媒体库的管理体验和使用价值。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
