A beautiful, modern video downloader powered by yt-dlp
Features • Platforms • Quick Start • Deployment • Docs
- 🎬 1000+ Sites - YouTube, Twitter/X, TikTok, Instagram, Bilibili, Niconico, SoundCloud, Spotify, and more
- 🎵 Audio Extraction - MP3, FLAC, WAV, M4A, OGG with customizable bitrate
- 📺 Video Quality - From 360p to 8K, with codec selection (H.264, H.265, VP9, AV1)
- 📝 Subtitles & Extras - Download subtitles, live chat replays, and comments
- 🎨 Beautiful UI - Modern, responsive design with dark theme
- 📋 Playlist Support - Download entire playlists or select specific videos
- 🔒 Cookie Support - Access age-restricted or region-locked content
- 🌐 Proxy Support - Route through proxies for geo-restricted content
- 🎯 Spotify Integration - Convert Spotify links to YouTube Music downloads with metadata
- ⚡ Fast Downloads - Multi-threaded with aria2c acceleration
- 🐳 Docker Ready - One-click deployment with Docker Compose
| Platform | Video | Audio | Playlists | Notes |
|---|---|---|---|---|
| YouTube | ✅ | ✅ | ✅ | Live chat & comments |
| YouTube Music | ✅ | ✅ | ✅ | |
| Twitter/X | ✅ | ✅ | ❌ | |
| TikTok | ✅ | ✅ | ❌ | |
| ✅ | ✅ | ❌ | Reels, Stories, IGTV | |
| SoundCloud | ✅ | ✅ | ✅ | |
| Spotify | ✅ | ✅ | ✅ | Via YouTube Music |
| Bilibili | ✅ | ✅ | ✅ | Requires cookies |
| Niconico | ✅ | ✅ | ✅ | |
| Vimeo | ✅ | ✅ | ❌ | |
| Dailymotion | ✅ | ✅ | ❌ | |
| Twitch | ✅ | ✅ | ❌ | Clips & VODs |
| ✅ | ✅ | ❌ | ||
| ✅ | ✅ | ❌ | ||
| Odysee | ✅ | ✅ | ❌ | |
| Direct Media | ✅ | ✅ | ❌ | MP4, MP3, M3U8, etc. |
Plus 1000+ more sites supported by yt-dlp
# Clone the repository
git clone https://github.com/serika-dev/serika-downloader.git
cd serika-downloader
# Install dependencies
bun install # or npm install
# Run development server
bun dev # or npm run dev
# Open http://localhost:3000# Install yt-dlp via winget
winget install yt-dlp
# Or run the setup script
.\install-ytdlp.ps1The easiest way to deploy Serika Downloader:
# Clone and start
git clone https://github.com/serika-dev/serika-downloader.git
cd serika-downloader
docker-compose up -d
# Open http://localhost:3000Or use the startup scripts:
# Windows PowerShell
.\start.ps1
# Windows Command Prompt
start.bat📖 Full Docker Guide: docs/docker.md
Deploy to your own server with Coolify:
- Create a new Docker Compose resource
- Connect your Git repository
- Configure domain and SSL
- Deploy!
📖 Full Coolify Guide: docs/coolify.md
- Railway - Use the Dockerfile
- Fly.io - Use the Dockerfile with
fly launch - DigitalOcean App Platform - Docker deployment
- AWS/GCP/Azure - Container instances
⚠️ Note: Vercel/Netlify are not recommended due to serverless function limits and lack of persistent storage.
| Document | Description |
|---|---|
| docs/docker.md | Docker Compose setup guide |
| docs/coolify.md | Coolify deployment with custom domain |
| docs/api.md | REST API documentation |
| docs/architecture.md | Technical architecture overview |
| Variable | Default | Description |
|---|---|---|
NODE_ENV |
development |
Environment mode |
PORT |
3000 |
Server port |
MAX_CONCURRENT_DOWNLOADS |
5 |
Max parallel downloads |
FILE_RETENTION_MS |
3600000 |
File cleanup (1 hour) |
The web UI provides extensive options:
- Video: Quality, codec, FPS, container format
- Audio: Format, bitrate, codec
- Metadata: Thumbnails, subtitles, chapters
- Extras: Live chat, comments (YouTube)
- Advanced: Cookies, proxy, custom yt-dlp args
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the Serika License - free to use with attribution to The Serika Company. See the LICENSE file for details.
This tool is for personal use only. Please respect copyright laws and the terms of service of the platforms you download from. The developers are not responsible for any misuse of this software.
Made with 💜 by Serika