nqdev/py-restream repository overview

⁠py-restream

Restream TikTok Live, Twitch hoặc Bigo sang YouTube Live 24/7, quản lý bằng web dashboard. Đã đóng gói sẵn FFmpeg.

• Nhiều phiên cùng lúc: mỗi phiên có log, terminal và chat riêng.
• Ít tốn CPU: video được copy thẳng (stream copy), chỉ encode lại audio sang AAC.
• Ba chế độ restream: RTMP bypass, direct URL, auto-extract (yt-dlp).
• Chạy ổn định: tự reconnect, tự làm mới URL, xử lý hạn mức YouTube API.
• YouTube Live Chat: đọc và trả lời chat ngay trong dashboard (OAuth 2.0).
• Playlist restream: phát liên tục danh sách link video YouTube/TikTok thành một buổi live.

⁠Chạy nhanh

docker run -d --name py-restream \
  -p 8000:8000 \
  -e TZ=Asia/Ho_Chi_Minh \
  -v py-restream-data:/app/data \
  -v py-restream-logs:/app/logs \
  --restart unless-stopped \
  nqdev/py-restream:latest

Mở http://localhost:8000⁠.

⁠Docker Compose

services:
  py-restream:
    image: nqdev/py-restream:latest
    container_name: py-restream-app
    restart: unless-stopped
    ports:
      - "8000:8000"
    env_file:
      - .env            # tuỳ chọn, xem mục "Cấu hình"
    environment:
      - TZ=Asia/Ho_Chi_Minh
    volumes:
      - py-restream-data:/app/data
      - py-restream-logs:/app/logs
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/healthz"]
      interval: 60s
      timeout: 10s
      retries: 3

volumes:
  py-restream-data:
  py-restream-logs:

⁠Tag

Image chỉ build cho linux/amd64 và chỉ được publish khi có tag release.

⁠Whisper (phụ đề / phiên âm)

Image trên Docker Hub không có Whisper (speech-to-text chạy local) để giữ dung lượng nhỏ, khoảng 680 MB thay vì khoảng 1,6 GB. Tính năng phụ đề tự động (WHISPER_ENABLE_CAPTIONS) và phiên âm trong Audio Tools sẽ báo lỗi nếu bạn bật.

Cần Whisper thì tự build từ source (chỉ chạy CPU):

git clone https://gitlab.com/quyit/vps-minipc/py-restream.git
cd py-restream
docker build -f docker/Dockerfile --build-arg WITH_WHISPER=1 -t py-restream:whisper .

⁠Cấu hình

Phần lớn cài đặt (đường dẫn FFmpeg, giới hạn phiên, TikTok/LLM, ...) lưu trong SQLite tại /app/data và chỉnh ở trang Settings của dashboard. Hãy gắn volume cho /app/data để không mất cài đặt khi nâng cấp.

Các khoá bí mật có thể truyền qua biến môi trường (đều tuỳ chọn):

⁠Volume và cổng

⁠Mã nguồn

Source, issue và tài liệu đầy đủ: https://gitlab.com/quyit/vps-minipc/py-restream⁠

⁠Giấy phép

Public domain (Unlicense).