中文 | Changelog

Demo

Features

• Video Downloading: Download YouTube, Bilibili, Twitch, MissAV and other yt-dlp-supported videos with a simple URL input.
• Video Upload: Upload local video files directly to your library with automatic thumbnail generation.
• TMDB Metadata Scraping: Automatically scrape movie and TV show metadata (title, description, poster, director, year, rating) from TMDB based on filename. Supports localized content matching your site language.
• Parallel Downloads: Queue multiple downloads and track their progress simultaneously.
• Batch Download: Add multiple video URLs at once to the download queue.
• Concurrent Download Limit: Set a limit on the number of simultaneous downloads to manage bandwidth.
• Cloud Storage Integration: Automatically upload videos and thumbnails to cloud storage (OpenList/Alist) after download.
• Auto Subtitles: Automatically download YouTube / Bilibili default language subtitles.
• Live Audio Translation (admin, optional): Stream the playing video's audio to Google Gemini Live Translation and play translated speech with live subtitles in the player's subtitle menu. Configure it under Settings → Basic → Video Playback (enable, Gemini API key, model, source/target language). The key is stored server-side and never sent to the browser. Privacy: while live translation is active, the video's audio is streamed to Google's Gemini API; transcripts are not persisted or logged. Requires an admin account when login is enabled and a same-origin (non-cross-origin) audio source.
• Collections: Organize videos into custom collections for easy access.
• Subscriptions: Manage YouTube, Bilibili and Twitch channel subscriptions to automatically download new content.
• RSS Feeds: Create private RSS links for external feed readers with per-link filters for channels, authors, tags, sources, recent videos, and item limits.
• Login Protection: Secure your application with password login and optional passkeys (WebAuthn).
• Visitor Users: Create named read-only visitor accounts for safe sharing without modification capabilities.
• Internationalization: Support for multiple languages including English, Chinese, Spanish, French, German, Japanese, Korean, Arabic, Portuguese, and Russian.
• Mobile Optimizations: Mobile-friendly tags menu and optimized layout for smaller screens.
• Cookie Management: Support for uploading cookies.txt to enable downloading of age-restricted or premium content.
• yt-dlp Configuration: Customize global yt-dlp arguments, network proxy, and other advanced settings via settings page.
• TMDB Integration: Configure your TMDB API key in settings to enable automatic metadata scraping for local video files. The scraper intelligently parses filenames to extract titles and matches them with TMDB database.
• Cloudflare Tunnel Integration: Built-in Cloudflare Tunnel support to easily expose your local MyTube instance to the internet without port forwarding.
• Task Hooks: Execute custom shell scripts at various stages of a download task (start, success, fail, cancel) for integration and automation. See Task Hooks Guide.
• Telegram Notifications: Receive instant notifications via Telegram bot when a download task succeeds or fails.
• Browser Extension: A Chrome extension to download videos directly from your browser. Supports all yt-dlp supported sites.

Browser Extension

For installation and usage instructions, please refer to Browser Extension.

MikMok

MikMok is a short-form video web client for MyTube. It connects to MyTube through the API and offers a feed-style viewing experience tailored for short videos.

Android Client

mytube-android is a native Android client for MyTube. It connects to your MyTube server through the API for browsing and playback on mobile devices.

MCP Server

mytube-mcp is a Model Context Protocol (MCP) server for MyTube. It exposes your MyTube instance to AI assistants and agents through the API, so they can search, manage, and play your video library on your behalf.

Directory Structure

For a detailed breakdown of the project structure, please refer to Directory Structure.

Runtime Storage Layout

By default, media and caches live under backend/uploads/:

Getting Started

Requirements: Node.js 20.19+, 22.12+, 23.x, 24.x, 25.x, or 26.x and npm v9+. The backend depends on better-sqlite3; unsupported Node versions fail during npm install (often with misleading node-gyp / Visual Studio errors on Windows). Docker images ship with Node 22.

For installation and setup instructions, please refer to Getting Started.

Visitor Accounts

When login protection is enabled, admins can create named visitor accounts under Settings -> Security. Visitor accounts are read-only, and account changes such as create, disable, delete, and password reset apply immediately without saving the broader settings form.

Existing installations with a shared visitor password are migrated automatically to a visitor account. Users who had the shared password can sign in with username visitor and the same password. The legacy shared-password login endpoint remains for compatibility and is deprecated.

Deployment Security Model

For the three-tier admin trust and deployment security model, please refer to Deployment Security Model.

API Endpoints

For a list of available API endpoints, please refer to API Endpoints.

Technology Stack

Backend

• Runtime: Node.js 20.19+, 22.12+, or 23.x–26.x with TypeScript
• Framework: Express.js
• Database: SQLite with Drizzle ORM
• Testing: Vitest
• Architecture: Layered architecture (Routes → Controllers → Services → Database)

Frontend

• Framework: React 19 with TypeScript
• Build Tool: Vite
• UI Library: Material-UI (MUI)
• State Management: React Context API
• Routing: React Router v7
• HTTP Client: Axios with React Query

Key Architectural Features

• Modular Storage Service: Split into focused modules for maintainability
• Downloader Pattern: Abstract base class for platform-specific implementations
• Database Migrations: Automatic schema updates using Drizzle Kit
• Download Queue Management: Concurrent downloads with queue support
• Video Download Tracking: Prevents duplicate downloads across sessions

Environment Variables

The application uses environment variables for configuration.

Frontend (frontend/.env)

VITE_API_URL=/api
VITE_BACKEND_URL=

Backend (backend/.env)

PORT=5551
# Optional: declare the admin trust boundary for this deployment.
# Valid values: application | container | host
# Default: container
# MYTUBE_ADMIN_TRUST_LEVEL=container

Data and uploads are stored under backend/data and backend/uploads by default (relative to the backend working directory).

Copy backend/.env.example to backend/.env and adjust as needed. The frontend ships with frontend/.env; use frontend/.env.local to override defaults.

Database

MyTube uses SQLite with Drizzle ORM for data persistence. The database is automatically created and migrated on first startup:

• Location: backend/data/mytube.db
• Migrations: Automatically run on server startup
• Schema: Managed through Drizzle Kit migrations
• Legacy Support: Migration tools available to convert from JSON-based storage

Key database tables:

• videos: Video metadata and file paths
• collections: Video collections/playlists
• subscriptions: Channel/creator subscriptions
• rss_tokens: Private RSS feed links, filters, access status, and access counters
• downloads: Active download queue
• download_history: Completed download history
• video_downloads: Tracks downloaded videos to prevent duplicates
• settings: Application configuration

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on how to get started, our development workflow, and code quality gu