leolion | 4 tháng trước | 3 min read

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

Plex Subtitle Service tự tìm subtitle còn thiếu, sync timing bị lệch và dịch bằng AI để giảm thao tác thủ công khi dùng Plex trong home media stack.

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ộ.

Giao diện Settings của Plex Subtitle Service với thống kê subtitle đã tải, đã dịch bằng AI và các tuỳ chọn xử lý tự động — Giao diện Settings cho thấy service tập trung các cấu hình tải subtitle, dịch AI, lọc chất lượng và tránh subtitle trùng.

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.

Màn hình Subtitle Sync của Plex Subtitle Service dùng AI model để kiểm tra và đồng bộ timing subtitle — Màn Sync Timing dùng để kiểm tra subtitle của media đang phát hoặc chạy thủ công cho một rating key cụ thể.

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.

Màn hình Subtitle Translation hiển thị media đang phát, trạng thái tìm subtitle và nút dịch AI sang tiếng Việt — Màn Translation cho phép dịch nhanh subtitle theo media đang phát hoặc nhập rating key/link Plex để xử lý thủ cô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

Mở http://your-server:8000/setup
Nhập Plex URL, Plex Token và Subsource API Key
(Tuỳ chọn) Nhập OpenAI API Key để bật AI sync/translate
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

Thêm media mới vào Plex.
Plex/Tautulli gửi webhook đến service.
Service tự tìm sub, lọc chất lượng và upload vào Plex.
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ử.