Skip to content

README_EN.md

Latest commit

 

History

History
222 lines (157 loc) · 8.77 KB

README_EN.md

File metadata and controls

222 lines (157 loc) · 8.77 KB

English Doc 中文文档

LunaTV Enhanced Edition

LunaTV Logo

🎬 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.

Next.js React TypeScript TailwindCSS ArtPlayer HLS.js License Docker Ready Version

📢 About

This project is a deep fork of MoonTV, starting from v4.3.1 and continuously iterated to the current v6.3.0, with 60+ major feature modules and 400+ detail optimizations. See CHANGELOG for all new features.

⚠️ Disclaimer

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.

💡 Key Enhancements

🎥 Content Ecosystem

  • 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, and live streaming
  • Cloud Drive Search: Advanced filtering and cache management
  • ACG Torrent Search: Mikan Project dual-source system
  • IPTV Live TV: m3u/m3u8 subscription, FLV streaming, EPG guide
  • 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

🎬 Player Enhancements

  • 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

🔔 Content Tracking System

  • 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 Recommendation System

  • 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

💬 Danmaku Ecosystem

  • 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 & Monitoring

  • Performance Dashboard: Complete API performance monitoring
  • Traffic Monitoring: Real traffic monitoring and domain analysis
  • Kvrocks Persistence: High-performance caching system

🚀 Quick Start

Docker Deployment (Recommended)

# 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 -d

Visit http://localhost:3000 to use.

Local Development

# Install dependencies
pnpm install

# Start development server
pnpm dev

Detailed Deployment Guide: View Full Documentation

📚 Documentation

Core Documentation

Feature Documentation

Integration Guides

Authentication

Advanced Configuration

🔧 Tech Stack

  • 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.15
  • State Management: TanStack Query 5.91.0
  • Database: Upstash Redis + Kvrocks
  • Deployment: Docker / Vercel / Render

📜 Changelog

See CHANGELOG for all version updates.

🔐 Security & Privacy

For detailed security configuration and privacy protection, see Security Documentation.

📄 License

CC BY-NC-SA 4.0

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.

🙏 Acknowledgments

Original Projects

Core Dependencies

Data Sources & Services

  • Douban — Movie information data
  • TMDB — Movie database
  • Bangumi — Anime information

Design & Implementation References

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!

Special Thanks

  • All sites providing free video APIs
  • Open-source community contributors
  • Users who provide feedback

📊 Star History

Star History Chart

If this project helps you, please give it a ⭐ Star!

Made with ❤️ by LunaTV Enhanced Edition Team