TPT Online Video

TPT Online Video is an Apache 2.0-licensed, self-hostable online video platform inspired by YouTube — built as a real distributed media infrastructure project, not a simple CRUD upload site.

Features

| Feature | Status | |---|---| | Resumable VOD uploads (presigned + chunked) | ✅ | | FFmpeg transcoding pipeline with HLS renditions | ✅ | | Adaptive bitrate playback (Shaka Player) | ✅ | | PostgreSQL FTS search with filters and ranking | ✅ | | Comments and engagement | ✅ | | JWT + opaque refresh token auth with token rotation | ✅ | | Argon2id password hashing | ✅ | | Roles and permissions (admin / moderator / user) | ✅ | | Full moderation workflow and audit log | ✅ | | RTMP live ingest (OBS / ffmpeg) | ✅ | | HLS live playback | ✅ | | WebRTC/WHEP low-latency playback | ✅ (experimental) | | Live DVR sliding-window rewind | ✅ | | Real-time live chat (WebSocket) | ✅ | | Abstracted storage (local filesystem / S3 / Wasabi) | ✅ | | Docker Compose local dev stack | ✅ | | Fully containerized production stack | ✅ | | Windows self-contained installer | ✅ | | Linux self-contained installer | ✅ |

Architecture

React Web UI (Vite + TypeScript)
    │
    ▼
Go API (chi, JWT, PostgreSQL, Redis)
    ├── PostgreSQL (metadata, auth, search, comments, moderation)
    ├── Redis (job queue, rate limiting, chat pub/sub)
    ├── Storage abstraction
    │       ├── Local filesystem
    │       ├── MinIO / S3-compatible
    │       └── Wasabi
    └── Transcoding queue
            │
            ▼
        Go Worker → FFmpeg → HLS renditions → Storage

OBS / Encoder
    │  (RTMP)
    ▼
MediaMTX
    ├── HLS live output
    ├── WebRTC/WHEP output
    └── DVR sliding window

Repository Layout

apps/
  web/                         React + TypeScript frontend

packages/
  auth/                        Argon2id hashing, JWT, token management
  media/                       FFmpeg transcoding helpers
  moderation/                  File type validation, ClamAV scanner interface
  search/                      Search provider abstraction (PostgreSQL FTS + Meilisearch)
  storage/                     Storage provider abstraction (local, S3, Wasabi)
  shared/                      Health check helpers

services/
  api/                         Go HTTP API
  worker/                      Go transcoding worker
  live/                        Go live-service helper

infra/
  installer/linux/             Systemd-based Linux installer
  installer/windows/           PowerShell/WinSW Windows installer
  nginx/                       Production reverse proxy configs

migrations/                    PostgreSQL migrations (golang-migrate)

docs/                          Full documentation

Quick Start

Prerequisites

Docker and Docker Compose
Go 1.22+
Node.js 20+ with pnpm
FFmpeg (for local transcoding)

Production (single command)

docker compose -f docker-compose.prod.yml build
docker compose -f docker-compose.prod.yml up -d

Access the app at http://localhost.

Development (hybrid)

# Start infrastructure
docker compose up -d postgres redis minio mediamtx

# Copy and edit environment
cp .env.example .env

# Run the API
cd services/api && go run ./cmd/tpt-api

# Run the worker (separate terminal)
cd services/worker && go run ./cmd/tpt-worker

# Run the frontend (separate terminal)
cd apps/web && pnpm install && pnpm dev

Configuration

All configuration is via environment variables. See .env.example for the full list.

Key variables:

| Variable | Description | Default | |---|---|---| | JWT_SECRET | JWT signing secret (must change in production) | change-me-in-development | | LIVE_HOOK_SECRET | MediaMTX webhook secret (must change in production) | changeme-live-hook-secret | | STORAGE_PROVIDER | local, s3, or wasabi | local | | POSTGRES_SSLMODE | PostgreSQL SSL mode | disable | | EMAIL_PROVIDER | log, smtp | log | | APP_ENV | development or production | development |

Deployment Guides

| Platform | Guide | |---|---| | Any VPS (generic) | docs/deployment/generic-vps.md | | Linode | docs/deployment/linode.md | | Windows Desktop | docs/deployment/windows-desktop.md | | Linux installer | docs/installer.md |

Documentation

License

Apache 2.0

tpt-online-video

Languages