wytui

A self-hosted web UI for yt-dlp, built with SvelteKit 5. Download videos from any yt-dlp compatible platform.

Features

• Download profiles — Pre-configured presets (4K, 1080p, 720p, 480p, MP3, AAC, FLAC) and custom profiles
• Two-tier storage — Temporary cache with configurable quota + permanent library organized by uploader
• Jellyfin integration — Auto library scan, thumbnail artwork, and deep-link to Jellyfin search
• Subscriptions — Monitor channels/playlists, auto-download new content on a schedule; backfill by date or download entire channels
• Livestream monitors — Watch livestreams, auto-download when live
• File reconciliation — Automatically detects and removes DB records for files deleted externally (e.g. via Jellyfin)
• Real-time progress — Server-Sent Events for live download status
• OIDC authentication — OpenID Connect SSO with admin/user roles
• Mobile-friendly — Web Share API on iOS for save-to-photos

Quick Start

Docker Compose

The docker-init.sh script automatically generates secure random credentials on first run:

./docker-init.sh up -d

This creates a .env file with secure random passwords. The file is auto-generated if it doesn't exist.

Manual setup (if you prefer):

# Generate secure secrets
export POSTGRES_PASSWORD=$(openssl rand -hex 32)
export AUTH_SECRET=$(openssl rand -hex 32)

# Save to .env file
echo "POSTGRES_PASSWORD=$POSTGRES_PASSWORD" > .env
echo "AUTH_SECRET=$AUTH_SECRET" >> .env

docker compose up -d

💾 Important: The .env file contains your database password. Back it up securely!

Helm

helm install wytui oci://ghcr.io/willuhmjs/wytui

With custom values:

helm install wytui oci://ghcr.io/willuhmjs/wytui -f values.yaml

The chart includes a bundled PostgreSQL by default. To use an external database:

postgresql:
  enabled: false
  secret:
    url: "postgresql://user:pass@host:5432/wytui?schema=public"

Environment Variables

Variable	Description
DATABASE_URL	PostgreSQL connection string
AUTH_SECRET	Session signing secret
AUTH_TRUST_HOST	Set true behind a reverse proxy (optional)
ORIGIN	Public URL of the app (optional, defaults to http://localhost:3000)
ADMIN_USERNAME	Auto-create admin user, skipping the setup wizard (optional)
ADMIN_PASSWORD	Password for the auto-created admin user (optional)
OIDC_ISSUER_URL	OIDC issuer URL (optional)
OIDC_CLIENT_ID	OIDC client ID (optional)
OIDC_CLIENT_SECRET	OIDC client secret (optional)
OIDC_DISPLAY_NAME	OIDC provider display name (optional, defaults to "SSO")

OIDC Authentication

wytui supports OpenID Connect for single sign-on. Set the OIDC_ISSUER_URL, OIDC_CLIENT_ID, and OIDC_CLIENT_SECRET environment variables to enable it.

When configuring your OIDC provider, use the following redirect URL:

https://<your-wytui-domain>/auth/oidc/callback

Users who sign in via OIDC are created with a default user role. An admin can promote them from the admin panel.

Tech Stack

• Frontend: SvelteKit 5 (Svelte with runes)
• Database: PostgreSQL with Prisma ORM
• Auth: Auth.js with OIDC support
• Real-time: Server-Sent Events (SSE)
• Styling: Custom dark theme CSS

Legal Disclaimer

This software is provided "as is" for personal and educational use. Users are solely responsible for ensuring their use complies with all applicable laws, terms of service, and copyright regulations. The developers assume no liability for misuse.

License

MIT License — see LICENSE file for details. The MIT license covers this software's code only; it does not grant rights to any third-party content.