KV-Tube

A modern, fast, and fully-featured YouTube-like video streaming platform. Built with a robust Go backend and a highly responsive Next.js frontend, KV-Tube is designed for seamless deployment on systems like Synology NAS via Docker.

Features

• Modern Video Player: High-resolution video playback with HLS support and quality selection.
• Fast Navigation: Instant click feedback with skeleton loaders for related videos.
• Infinite Scrolling: Scroll seamlessly through a dynamic video grid on the homepage.
• Watch History & Suggestions: Keep track of what you've watched seamlessly! Fully integrated library history tracking.
• Subscriptions Management: Keep up to date with seamless subscription updates for YouTube channels.
• Optimized for Safari: Stutter-free playback algorithms and high-tolerance Hls.js configurations tailored for macOS users.
• Background Audio: Allows videos to continue playing audio when the browser tab is hidden or device locked (perfect for music).
• Progressive Web App: Fully installable PWA out of the box with offline fallbacks and custom vector iconography.
• Region Selection: Tailor your content to specific regions (e.g., Vietnam).
• Responsive Design: Beautiful, mobile-friendly interface with light and dark theme support.
• Containerized: Fully Dockerized for easy setup using docker-compose.

Architecture

• Backend & Frontend: Go (Gin framework) and Next.js are combined into a single unified Docker container using a multi-stage Dockerfile.
• Process Management: supervisord manages the concurrent execution of the backend API and Next.js frontend within the same network namespace.
• Data storage: SQLite is used for watch history, optimized for linux/amd64.

Deployment on Synology NAS

We recommend using Docker Compose for simple and robust deployment.

1. Prerequisites

• Docker and Container Manager installed on your Synology NAS.
• Make sure ports 5011 are free, or adjust docker-compose.yml to fit your needs.

2. Setup

Create a docker-compose.yml file matching the one provided in the repository:

version: '3.8'

services:
  kv-tube-app:
    image: git.khoavo.myds.me/vndangkhoa/kv-tube-app:v4.0.6
    container_name: kv-tube-app
    restart: unless-stopped
    ports:
      - "5011:3000"
    volumes:
      - ./data:/app/data
    environment:
      - KVTUBE_DATA_DIR=/app/data
      - GIN_MODE=release
      - NODE_ENV=production

3. Run

In the directory containing your docker-compose.yml, run:

docker-compose up -d

The application will be accessible at http://<your-nas-ip>:5011.

Development

• Frontend builds can be started in frontend/ via npm run dev.
• Backend server starts in backend/ via go run main.go.