starducktea/nfo-translator

NFO Monitor & Translator v1.5.5

基于FastAPI的轻量级工具，用于监控.nfo文件并自动在简体与繁体中文之间翻译元数据（标题、剧情、类型等），依赖OpenCC和PostgreSQL实现转换与数据存储。

核心功能

🔄 智能UI自动刷新

仪表盘采用智能更新逻辑优化资源与浏览器性能：

• 空闲状态：系统就绪且无任务时，页面保持静态。
• 活跃状态：触发扫描（Web UI或API）后，服务器注入<meta http-equiv="refresh" content="3">标签。
• 自动停止：浏览器每3秒刷新显示实时日志，任务完成后自动移除刷新标签。

🚀 自动化与API触发

v1.5.5版本使用安全的POST方法支持远程自动化，可与其他容器集成：

• 端点：http://<server-ip>:8000/trigger
• 方法：POST
• 内容类型：application/json
• JSON payload（需包含API密钥）：

json
{
  "key": "your_api_key_here"
}

使用场景

适用于媒体库管理场景，自动转换.nfo文件中的简繁体元数据，满足不同语言用户的查看需求，提升媒体库内容的兼容性与易用性。

配置说明

通过环境变量配置核心参数：

• PUID：运行容器的用户ID
• PGID：运行容器的组ID
• API_KEY：API调用的密钥
• TRANS_MODE：翻译模式（如s2t表示简转繁）
• DATABASE_URL：PostgreSQL数据库连接地址

🚀 快速启动（Docker Compose）

yaml
version: '3.8'

services:
  app:
    image: starducktea/nfo-translator:latest
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
    environment:
      - PUID=1000
      - PGID=100
      - API_KEY=<YOUR_API_KEY>
      - TRANS_MODE=s2t
      - DATABASE_URL=postgresql://<POSTGRES_USER>:<POSTGRES_PASS>@db:5432/<POSTGRES_DB>

🗄️ 数据库管理

手动创建数据库

若使用现有PostgreSQL服务器，需在同一实例中创建专用数据库：

1. 进入Postgres容器：

bash
docker exec -it <postgres_container_name> psql -U <username>

2. 创建数据库：

sql
CREATE DATABASE <POSTGRES_DB>;