ceru007/tmdb-helper repository overview

⁠🎬 TMDB Helper - 影视数据库管理工具

一个功能强大的TMDB (The Movie Database) 内容管理和维护平台

⁠📖 项目简介

TMDB Helper 是一个专为影视内容管理者和TMDB贡献者设计的现代化Web应用程序。它提供了完整的电影、电视剧词条管理功能，支持批量数据处理、自动化任务调度和智能图像处理，让TMDB内容维护变得更加高效和便捷。

⁠主要特性

⁠🎬 核心功能

• 词条维护：通过 TMDB API 进行搜索导入连载影视信息并跟踪维护状态。
• 独立维护：适用于维护已完结但未跟踪的连载影视。
• 定时任务：设置自动化任务，支持定期同步一周单更、一周双更、日更的影视。

⁠🎥 影视资讯

• 即将上线：查看未来30天将要上线的影视内容，支持多地区数据源。
• 近期开播：查看过去30天内刚刚开播的影视动态，及时了解最新内容。
• 流媒体导航：全球主流流媒体平台导航，支持分类筛选和自定义排序。

⁠🖼️ 图像处理

• 本地视频缩略图提取：自动识别并排除字幕区域进行裁剪出缩略图。
• 智能图片裁切：支持16:9比例的自动裁切和手动调整。

⁠🔧 集成工具

• 集成TMDB-Import：在词条详情页面进行可视化操作。
• TMDB-Import更新：一键下载、安装和更新TMDB-Import工具。
• config.ini文件快捷设置：在设置页面提供界面调节TMDB-Import的设置。

⁠📝 AI 分集简介生成器

• 🤖 多模型支持: 支持 DeepSeek-R1、Qwen2.5 等多种 AI 模型。
• 🎨 多样化风格: 提供Netflix、CR、官方、文艺、悬疑、幽默、模仿等多种写作风格。
• 📁 批量处理: 支持批量上传字幕文件，一键生成多集简介。
• 📤 格式导出: 支持导出为 TMDB-Import 兼容的 CSV 格式。
• ✏️ 实时编辑: 生成后可直接在界面中编辑和优化简介内容。

⁠⚠️ 使用提醒

• AI 生成的分集简介仅作辅助作用，请务必观看对应视频内容审核修改后再使用。
• 禁止直接上传至 TMDB 等数据库平台，需要人工审核和完善

⁠⚠️ AI常见错误

• AI单纯从字幕中有时很难分辨主语，需要人工进行核对。
• AI生成后出现语句不通顺、卡词、读起来拗口的情况。
• AI理解出错，导致剧情衔接错乱，例如先发生的事件出现在后文。后发生的事件出现在开头。

⁠🚀 快速开始

⁠使用Docker运行

# 拉取镜像
docker pull ceru007/tmdb-helper:latest

# 运行容器
docker run -d \
  --name tmdb-helper \
  -p 4949:4949 \
  -v tmdb_data:/app/data \
  -e ADMIN_USERNAME=admin \
  -e ADMIN_PASSWORD=your_secure_password \
  -e JWT_SECRET=your_jwt_secret_key \
  ceru007/tmdb-helper:latest

⁠使用Docker Compose

version: '3.8'
services:
  tmdb-helper:
    image: ceru007/tmdb-helper:latest
    container_name: tmdb-helper
    ports:
      - "4949:4949"
    environment:
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=your_secure_password
      - JWT_SECRET=your_jwt_secret_key
    volumes:
      - tmdb_data:/app/data
    restart: unless-stopped

volumes:
  tmdb_data:

⁠🔧 环境变量配置

⁠📋 系统要求

• 内存: 最少512MB，推荐1GB
• 存储: 最少1GB可用空间
• 端口: 4949（可配置）
• Docker: 版本20.10+

⁠🔗 相关链接

• GitHub仓库: CeRu-007/TMDB-Helper⁠
• 问题反馈: GitHub Issues⁠
• 文档: 详见GitHub仓库README

⁠📄 许可证

本项目采用 MIT 许可证开源。

⁠🏷️ 标签

tmdb movie-database tv-shows media-management nextjs docker automation image-processing web-app content-management

访问地址: 部署后通过 http://your-server-ip:4949⁠ 访问应用