🎬 LunaTV Enhanced Edition is a comprehensive video streaming platform based on MoonTV with extensive enhancements. Features include YouTube Integration, Cloud Drive Search, AI Recommendations, Short Drama, IPTV Live TV, Bangumi Anime, Watch Statistics, Danmaku System, and 60+ major feature additions for the ultimate viewing experience.
This project is a deep fork of MoonTV, starting from v4.3.1 and continuously iterated to the current v6.6.3, with 60+ major feature modules and 400+ detail optimizations. See CHANGELOG for all new features.
This project is for educational purposes only. Do not use for commercial purposes. All video content comes from third-party platforms. This project does not store any video files. Users are solely responsible for any legal consequences arising from the use of this project.
- Multi-User Watch Room: Synchronized playback, screen sharing, real-time chat, voice calls, WebRTC streaming, adjustable quality presets → Documentation
- Emby Private Library: Complete Emby media server integration with passwordless login, auth mode switcher, and multi-audio track playback → Documentation
- YouTube Integration: Full YouTube search, playback, live streaming, popular videos with region selector
- Bilibili Integration: Bilibili search and playback with UP主 videos, popular videos, QR code login, cookie management
- Cloud Drive Search: Advanced filtering and cache management, PanSou authentication support
- ACG Torrent Search: Mikan Project dual-source system + Nyaa search with download export
- IPTV Live TV: m3u/m3u8 subscription, FLV streaming, EPG guide, M3U import/export
- Bangumi Anime: Intelligent anime detection and API integration
- Traditional Chinese Search: Smart conversion and multi-strategy search
- Search List View: Grid/list dual view mode with image preview and quick play button
- Douban Quick Info Panel: Mobile ActionSheet with Douban details via quick-info and suggest API
- TMDB Hero Banner: Play page uses TMDB backdrop as main visual with logo, poster, rating, overview, and multi-season badge
- Episode Selector Enhancement: Manual speed test feature with real-time source status badges (Available/Unavailable/Testing)
- Control Bar Opacity Control: Customizable control bar obstruction (10-80%), real-time transparency and blur adjustment for better subtitle visibility
- Seek Buttons: Customizable seek forward/backward buttons with Netflix-style design and responsive layout
- Ultrawide Monitor Support: Video display mode control for ultrawide monitors
- Skip Presets: Flexible intro/outro template system with import/export and validation
- Persistent Playback Rate: Remember playback speed settings across sessions
- Multi-Audio Track Support: Auto-select browser-compatible audio tracks for Emby playback with track switching; custom X-Emby-Authorization header support
- Video Resolution Filtering: Auto-infer video stream resolution with resolution-based source filtering
- Upcoming Content Reminders: Complete watchlist and reminder system for upcoming content
- Auto Release Notifications: Automatic push notifications when favorited content is released
- Invite Code System: Registration system with invite codes, history tracking, and management
- AI Assistant: GPT-5/o series models support, streaming → Documentation
- Tavily Search Mode: Search mode without AI API
- TMDB Actor Search: Complete actor search, filtering, and caching
- Release Calendar: Preview and track upcoming content
- Third-party Danmaku API: Integration with Tencent, iQiyi, Youku, Bilibili
- Smart Performance: Tiered rendering, Web Worker acceleration
- Manual Danmaku Matching: Precise danmaku retrieval
- Comprehensive Settings: Complete danmaku configuration panel
- Performance Dashboard: Complete API performance monitoring
- Traffic Monitoring: Real traffic monitoring and domain analysis
- Enhanced Watch Statistics: Records login IP, geolocation (city/region/country), device type, browser and OS per login — visible to admins in the stats dashboard
- Kvrocks Persistence: High-performance caching system
- TanStack Query Full Integration:
- Smart data caching and automatic revalidation
- Infinite scroll optimization (Douban, ShortDrama pages)
- Virtual scrolling for large list performance
- Unified API cache strategy (2 hours)
- Reduced unnecessary network requests and re-renders
# Clone the project
git clone https://github.com/SzeMeng76/LunaTV.git
cd LunaTV
# Copy environment variables
cp .env.example .env
# Edit .env file and configure necessary environment variables
nano .env
# Start services
docker-compose up -dVisit http://localhost:3000 to use.
# Install dependencies
pnpm install
# Start development server
pnpm devDetailed Deployment Guide: View Full Documentation
- 📖 Documentation Center - Navigation page for all docs
- 🚀 Deployment Guide - Docker, Vercel deployment
- ⚙️ Configuration - Environment variables and settings
- 📱 Mobile Guide - Mobile APP and AndroidTV usage
- 🔧 Proxy Config
- 🚫 Ad Filter
- ⏭️ Skip Controller
- Frontend: Next.js 16.1.0 + React 19.0.0
- Language: TypeScript 5.8.3
- Styling: TailwindCSS 4.1.18
- Video Player: ArtPlayer 5.4.0 + HLS.js 1.6.16
- State Management: TanStack Query 5.100.14 (fully migrated, optimized data fetching and caching)
- Database: Upstash Redis / Kvrocks / SQLite (three storage backends available)
- Deployment: Docker / Vercel / Render / Tencent EdgeOne
See CHANGELOG for all version updates.
For detailed security configuration and privacy protection, see Security Documentation.
This project is licensed under CC BY-NC-SA 4.0.
This means:
- ✅ You are free to share, copy, and modify this project
- ✅ You must give appropriate credit and provide a link to the license
- ❌ You may not use this project for commercial purposes
⚠️ If you remix, transform, or build upon the material, you must distribute your contributions under the same license
© 2025-2026 LunaTV Enhanced Edition & Contributors
Based on MoonTV.
- MoonTV — Original project
- Selene — Official mobile APP (iOS / Android phones)
- Selene-TV — Official Android TV client, optimized for remote control devices
- LibreTV — Inspiration source
- Next.js — React framework
- ArtPlayer — Powerful web video player
- HLS.js — HLS streaming support
- TanStack Virtual — Virtual scrolling component
- Tailwind CSS — CSS framework
This project references design ideas and implementations from these excellent open-source projects:
- MoonTVPlus — Watch room sync playback, mobile optimization
- DecoTV — TVBox security strategy, performance optimization, UI design
Thanks to these projects and their authors for their open-source contributions!
- All sites providing free video APIs
- Open-source community contributors
- Users who provide feedback
If this project helps you, please give it a ⭐ Star!
Made with ❤️ by LunaTV Enhanced Edition Team