MoonTechLab / LunaTV
MoonTechLab / LunaTV
MoonTV 🎬
MoonTV is an out-of-the-box, cross-platform video aggregation player. Built on Next.js 14 + Tailwind CSS + TypeScript, it supports multi-source searching, online playback, collection synchronization, playback history, and cloud storage, allowing you to enjoy massive amounts of free video content anytime, anywhere.
MoonTV 🎬 MoonTV 是一个开箱即用的、跨平台的影视聚合播放器。它基于 Next.js 14 + Tailwind CSS + TypeScript 构建，支持多资源搜索、在线播放、收藏同步、播放记录、云端存储，让你可以随时随地畅享海量免费影视内容。
✨ Key Features
- 🔍 Multi-source Aggregated Search: Get results from all sources with a single search.
- 📄 Rich Detail Pages: Displays complete information including episode lists, cast, release year, and synopses.
- ▶️ Smooth Online Playback: Integrated with HLS.js & ArtPlayer.
- ❤️ Favorites + Continue Watching: Supports Kvrocks/Redis/Upstash storage for cross-device progress sync.
- 📱 PWA: Offline caching, desktop/home screen installation, and native mobile experience.
- 🌗 Responsive Layout: Desktop sidebar + mobile bottom navigation, adaptive to all screen sizes.
- 👿 Smart Ad-blocking: Automatically skips in-video slice ads (experimental).
✨ 功能特性
- 🔍 多源聚合搜索：一次搜索立刻返回全源结果。
- 📄 丰富详情页：支持剧集列表、演员、年份、简介等完整信息展示。
- ▶️ 流畅在线播放：集成 HLS.js & ArtPlayer。
- ❤️ 收藏 + 继续观看：支持 Kvrocks/Redis/Upstash 存储，多端同步进度。
- 📱 PWA：离线缓存、安装到桌面/主屏，移动端原生体验。
- 🌗 响应式布局：桌面侧边栏 + 移动底部导航，自适应各种屏幕尺寸。
- 👿 智能去广告：自动跳过视频中的切片广告（实验性）。
⚠️ Important Notice
After deployment, the project is an empty shell with no built-in playback or live streaming sources; you must configure these yourself. Please do not promote this project on Bilibili, Xiaohongshu, WeChat Official Accounts, Douyin, Toutiao, or other mainland Chinese social platforms. We do not authorize any “Tech Weekly/Monthly” projects or sites to index this project.
注意：部署后项目为空壳项目，无内置播放源和直播源，需要自行收集。请不要在 B站、小红书、微信公众号、抖音、今日头条或其他中国大陆社交平台发布视频或文章宣传本项目，不授权任何“科技周刊/月刊”类项目或站点收录本项目。
🗺 Table of Contents
- Tech Stack
- Deployment (One-click / Docker)
- Configuration File
- Subscription
- Auto-update
- Environment Variables
- Client (AndroidTV)
- Roadmap
- Security & Privacy
- License
- Acknowledgments
🗺 目录
- 技术栈
- 部署 (一键部署 / Docker 部署)
- 配置文件
- 订阅
- 自动更新
- 环境变量
- 客户端 (AndroidTV)
- Roadmap
- 安全与隐私提醒
- License
- 致谢
Tech Stack
| Category | Main Dependencies |
|---|---|
| Frontend Framework | Next.js 14 · App Router |
| UI & Styling | Tailwind CSS 3 |
| Language | TypeScript 4 |
| Player | ArtPlayer · HLS.js |
| Code Quality | ESLint · Prettier · Jest |
技术栈
| 分类 | 主要依赖 |
|---|---|
| 前端框架 | Next.js 14 · App Router |
| UI & 样式 | Tailwind CSS 3 |
| 语言 | TypeScript 4 |
| 播放器 | ArtPlayer · HLS.js |
| 代码质量 | ESLint · Prettier · Jest |
Deployment
This project only supports deployment via Docker or Docker-based platforms.
部署 本项目仅支持 Docker 或其他基于 Docker 的平台部署。
Zeabur One-Click Deployment
Click the button below to deploy instantly with automatic configuration of LunaTV + Kvrocks database.
- Advantages: No configuration required, automatic HTTPS/CDN, persistent storage, and sufficient free tier for personal use.
Zeabur 一键部署 点击下方按钮即可一键部署，自动配置 LunaTV + Kvrocks 数据库：
- 优势：无需配置，一键启动（自动部署完整环境）、自动 HTTPS 和全球 CDN 加速、持久化存储、数据永不丢失、免费额度足够个人使用。
(Note: For detailed Docker Compose configurations for Kvrocks, Redis, and Upstash, please refer to the original documentation provided in the source.)
(注：关于 Kvrocks、Redis 和 Upstash 的详细 Docker Compose 配置，请参考原文提供的详细说明。)