Plex Subtitle Service: Tự tìm sub, sync lệch và dịch bằng AI

Nếu bạn dùng Plex thường xuyên, chắc hẳn đã từng gặp cảnh phim mới có nhưng chưa có subtitle phù hợp, hoặc subtitle bị lệch vài giây làm trải nghiệm xem tụt hẳn. plex-sub-downloader được sinh ra để xử lý đúng bài toán đó theo cách tự động hóa gần như toàn bộ.

Những tính năng chính đáng giá

1) Tự tìm và tải subtitle

• Ứng dụng nhận webhook từ Plex hoặc Tautulli khi có media mới hoặc khi bắt đầu phát.
• Tự động tìm subtitle từ Subsource theo ngôn ngữ bạn cấu hình.
• Upload trực tiếp vào Plex, không cần thao tác tay từng file.

2) Đồng bộ subtitle bị lệch (sync timing)

• Khi subtitle lệch so với bản encode hiện tại, ứng dụng có thể tự căn lại timing.
• Giảm việc phải chỉnh delay thủ công trên TV/điện thoại/máy tính bảng.
• Rất hữu ích với các bản sub cộng đồng có độ lệch khác nhau giữa các release.

3) Dịch subtitle bằng AI

• Dịch subtitle từ ngôn ngữ nguồn sang ngôn ngữ đích bạn mong muốn.
• Có chế độ yêu cầu duyệt trước khi dịch để kiểm soát chi phí API.
• Phù hợp khi không có sub tiếng Việt hoặc bản dịch sẵn chưa đạt chất lượng.

Ngoài ra, ứng dụng còn có Web UI để cấu hình nhanh, theo dõi log real-time và quản lý quy trình xử lý subtitle tập trung.

Hướng dẫn cài đặt

Yêu cầu

• Docker và Docker Compose
• Plex Media Server (đã bật Webhooks)
• Tài khoản Subsource + API key

Docker Compose mẫu

services:
  plex-subtitle-service:
    image: ghcr.io/leolionart/plex-sub-downloader:latest
    ports:
      - "8000:8000"
    volumes:
      - ./data:/app/data
    environment:
      - PLEX_URL=http://192.168.1.x:32400
      - PLEX_TOKEN=your_plex_token
      - SUBSOURCE_API_KEY=your_subsource_key
    restart: unless-stopped

docker compose up -d

Thiết lập ban đầu

1. Mở http://your-server:8000/setup
2. Nhập Plex URL, Plex Token và Subsource API Key
3. (Tuỳ chọn) Nhập OpenAI API Key để bật AI sync/translate
4. Lưu cấu hình và kiểm tra kết nối

Webhook

• Plex: Settings → Webhooks → http://your-server:8000/webhook
• Tautulli: Notification Agents → Webhook cùng endpoint

Hướng dẫn sử dụng

Luồng tự động hằng ngày

1. Thêm media mới vào Plex.
2. Plex/Tautulli gửi webhook đến service.
3. Service tự tìm sub, lọc chất lượng và upload vào Plex.
4. Nếu bật AI sync/translate, subtitle sẽ được đồng bộ và dịch theo cấu hình.

Luồng thủ công khi cần can thiệp

• Vào /sync để chạy sync/translate cho media cụ thể.
• Vào /translation để duyệt yêu cầu dịch trước khi thực thi.
• Vào /logs để theo dõi log real-time khi cần debug.

Kết luận

plex-sub-downloader là một giải pháp rất thực dụng cho home media stack: giảm thao tác thủ công, tăng chất lượng trải nghiệm xem và mở rộng tốt khi thư viện phim lớn dần.

Nếu bạn muốn Plex “tự lo phần subtitle” một cách thông minh hơn, đây là dự án rất đáng thử.