本帖最后由 绣工坊墙布 于 2026-7-12 11:50 编辑
柠檬影视TV v1.0.4
专为 Android TV / 电视盒子打造的 MacCMS 影视客户端
开源免费 · 免部署可用 · NAS自建支持 · 当前稳定版 v1.0.4
各位大佬好！
玩电视盒子、NAS 的朋友，应该都折腾过 苹果 CMS（MacCMS V10） —— 自己在 NAS 或软路由上搭一套影视站，局域网全家看，数据自己掌控。
但 MacCMS 的 TV 端客户端 一直是个痛点：手机版界面小、焦点乱；很多通用播放器又不认 MacCMS API，体验一般。
今天分享一款我在用的开源项目：柠檬影视TV（lemonTV-Film），当前稳定版 v1.0.4，专为 Android TV / 电视盒子 设计，配合 MacCMS 使用体验很好。
两种用法，按需选择：
① 懒人方案：填一个公开 API 的 MacCMS 地址，不用自己部署，装好就能看 github仓库有推荐站点（说明：以上为第三方公开站点，内容与稳定性由对方维护，与本 APP 及本帖作者无关。若失效可自行搜索其他「MacCMS 公开 API」站点替换，只要满足下方条件即可。）
② 折腾方案：NAS / 宝塔 / Docker 自建 MacCMS，数据完全自己掌控
本帖结构：
① APP 功能介绍 + 界面预览
② 零部署快速体验（推荐新手先看）
③ MacCMS 自建部署教程（NAS / 宝塔 / Docker）
④ API 开启与自检
⑤ APP 连接配置
⑥ 常见问题
★ 第一部分：柠檬影视TV 介绍 ★
一、这是什么？
柠檬影视TV 是一款专为 Android TV / 电视盒子 打造的 MacCMS 影视客户端。
应用名称：柠檬影视TV
包名：com.lemon.yingshi.tv
当前版本：v1.0.4（稳定版）
最低系统：Android 5.0（API 21）
开源地址： 网盘下载地址：
重要说明：
- APP 不内置任何影视源，需要连接 MacCMS 站点才能使用
- 可以 自建 MacCMS，也可以 接入他人已公开 API 的 MacCMS 站点
- 接入前提：目标站点必须 开启了视频采集 API，否则 APP 拉不到数据
- 本帖仅分享开源客户端及使用方法，不提供、不保证任何第三方站点内容
二、核心功能亮点
1. 专为 TV 遥控器优化
- 基于 Jetpack Compose for TV，大屏焦点导航流畅
- 方向键移动焦点，OK 确认，返回键逐级退出
- 播放页左右键快进快退，时长可在设置中调节（15 / 20 / 25 / 30 / 35 秒）
- 首页分类设置弹窗支持 长按 ↓ 快速跳到保存、长按 ↑ 快速回到列表顶部
2. 首页浏览
- 最近播放：自动记录进度，显示已看/剩余时长，一键续播
- 最新推荐：展示 MacCMS 推荐等级（level=9）内容，11 张卡片 +「更多」入口
- 分类栏目：从 MacCMS 服务器读取 全部分类；首次连接默认在首页展示 几个顶级大类（如电影、连续剧、综艺、动漫等），界面清爽不杂乱
- 筛选 / 搜索：筛选页可浏览 服务器返回的全部一级分类；支持按类型、地区、年份筛选及搜索历史
- 分阶段加载：优先展示可见内容，后台补全封面，打开更快
首页分类说明： APP 会从 MacCMS 拉取完整分类树。不想自己部署、直接接入公开站点的用户，首页默认只显示 顶级大类 + 最新推荐栏，够用了；想显示更多分类或二级类目，可到 设置 → 首页设置 → 首页分类设置 里自由开关和排序。
3. 播放器（ExoPlayer / Media3）
- 记忆续播：可开关；再次打开可选「继续播放」或「从头开始」
- 变速播放：0.25X ~ 2.0X 共 8 档倍速
- 选集切换：播放器内分页选集（每页 20 集），支持上一集 / 下一集
- 智能跳过片头片尾：按 整部剧集 统一配置，对该剧所有集数生效
- HLS 预缓存：进度条下方显示预缓存进度（如 预缓存 402/465），播放更稳
- 进度条拖拽预览：拖动时显示目标时间点
- 多集播放结束自动跳转下一集
4. 设置中心（四大模块）
资源管理 — 配置 MacCMS 地址、保存、测试连通性、显示分类数量与 MacCMS 版本
首页设置 — 自定义首页分类显示/排序、清除缓存
播放设置 — 快进快退时长、记忆续播开关、清空播放记录
关于应用 — GitHub 版本更新检测、播放统计、项目信息
5. 其他
- GitHub Releases 在线更新（设置图标红点提示新版本）
- 远程通知栏（支持 JSON 配置）
- 完全开源，欢迎 Star / Issue / PR
三、界面预览
【图1 - APP 图标】
柠檬黄主题 Logo，辨识度高。
【图2 - 首页】
最近播放 + 最新推荐 + 分类栏目；底部导航：首页 / 筛选 / 设置。
【图3 - 播放器】
变速（1.0X）、选集、跳过片头片尾；HLS 预缓存状态；进度条拖拽时间预览。
【图4 - 资源管理】
配置 MacCMS 服务器地址，测试连通性，显示 MacCMS 版本与分类数量。
【图5 - 首页分类设置】
开关各分类是否在首页显示，↑↓ 调整排序，TV 遥控器操作说明清晰。
【图6 - 播放设置】
快进快退 15 秒、记忆续播开关、清空播放记录。
【图7 - 关于应用】
v1.0.2 稳定版，GitHub 链接，应用统计。
★ 第二部分：零部署快速体验 ★
不想自建？填地址就能用！
没有 NAS、不想折腾建站？ 可以直接接入 已公开视频 API 的 MacCMS 站点，3 步搞定，和自建用法完全一样。
四、推荐：公开 API 的 MacCMS 站点
网上有一些 MacCMS 站点已开启 视频采集 API，填入 APP 即可使用，无需自己部署服务器。
示例站点（作者 README 推荐）：
githbu仓库地址(去GitHub仓库查看推荐公开API站点) 本来是发上来了，但是我自己都没发现里面带有XX内容，所以现在删除了，你们需要自己去仓库看吧，尽量去找对身心健康的站点
说明：以上为第三方公开站点，内容与稳定性由对方维护，与本 APP 及本帖作者无关。若失效可自行搜索其他「MacCMS 公开 API」站点替换，只要满足下方条件即可。
可用站点需满足：
- 基于 MacCMS V10（或兼容其 API 协议）
- 已开启 视频 API（/api.php/provide/vod 可访问）
- 站点有影视数据（列表、详情、播放地址正常）
浏览器自测（把地址换成你的站点）：
- https://域名/api.php/provide/vod/?ac=list&pg=1&pagesize=5
正常应返回 JSON/XML，且 code=1，list 中有视频条目。
五、免部署 3 步上手
第 1 步：安装 APP
从 GitHub Releases 下载最新 APK：
U 盘 / ADB / 当贝 / 沙发管家等方式安装到电视或盒子即可。
第 2 步：填入公开站点地址
- 打开 APP → 底部 设置 → 左侧 资源管理
- 服务器地址 填写站点根地址，例如：
- 点击 保存配置 → 测试连通性
- 状态显示 已连接，并出现 分类数量、MacCMS 版本等信息
地址填写规则：
正确 ✓ https://xsd.域名.com
正确 ✓ http://192.168.0.16:7963
错误 ✗ https://xsd.域名.com/api.php
错误 ✗ https://xsd.域名.com/admin.php
第 3 步：返回首页，直接看
连接成功后返回 首页，会自动加载：
最新推荐 — 读取 MacCMS 推荐等级 level=9 的内容，首页展示推荐卡片
分类栏目 — 从服务器读取 全部分类；默认只显示几个顶级大类（如电影、连续剧、综艺、动漫），首页不拥挤
筛选页 — 底部点 筛选，可浏览该站 全部一级分类，数据比首页更全
搜索 — 顶部搜索图标，按片名搜索全站内容
想自定义首页显示哪些分类？
设置 → 首页设置 → 首页分类设置 → 开关各分类、调整排序 → 保存
六、免部署 vs 自建，怎么选？
免部署（公开 API 站点）
难度：★ 极低，填地址即用
数据掌控：依赖第三方站点
局域网速度：看公网站点速度
适合人群：想快速体验、不想折腾
自建（NAS / 宝塔 / Docker）
难度：★★★ 需部署 MacCMS + 开 API
数据掌控：完全自己掌控
局域网速度：局域网内通常更快
适合人群：NAS 玩家、长期自用
建议： 先按 免部署方案 体验 APP 功能和界面；满意后再考虑 NAS 自建，长期更稳。
★ 第三部分：MacCMS 自建部署教程 ★
进阶玩家 · NAS / 宝塔 / Docker
如果你有自己的 NAS、软路由或小主机，自建 MacCMS 是更推荐的长期方案。
柠檬影视TV 通过 MacCMS 的 视频采集 API（api.php/provide/vod）拉取分类、列表、详情与播放地址。
部署好 MacCMS + 开启视频 API = APP 就能用了。
七、环境要求
PHP：7.4 ~ 8.1（扩展：mysqli、curl、gd、mbstring、xml）
MySQL：5.7 / 8.0
Web 服务：Nginx 或 Apache
MacCMS：苹果 CMS V10
八、方式一：NAS 部署（家庭用户推荐）
适合群晖、威联通、飞牛 NAS 或家里常开电脑，电视与 NAS 在同一局域网即可。
8.1 群晖 NAS
- 安装 Web Station、**MariaDB/MySQL**、**PHP 7.4+**
- 创建数据库（如 maccms），记下账号密码
- 下载 苹果 CMS V10 源码，解压到 Web 目录（如 /web/maccms）
- Web Station 新建虚拟主机，端口可设 7963
- 浏览器访问
- http://群晖IP:7963/install.php
- 安装后 务必修改 默认管理员密码
访问地址：
前台：http://192.168.0.16:7963/
后台：http://192.168.0.16:7963/admin.php
8.2 威联通 / 飞牛 / 其他 NAS
思路相同：安装 Web 环境 → 上传 MacCMS V10 源码 → 访问 install.php 完成安装。
威联通用户也可直接用 Container Station + Docker（见方式三）。
8.3 导入影视数据（建议做）
- 后台采集：登录后台 → 采集 → 添加联盟资源/自定义接口 → 执行采集
- 手动添加：后台 视频 → 添加，录入测试影片
九、方式二：宝塔面板部署
- 安装宝塔，软件商店安装 Nginx + MySQL + PHP 7.4
- 新建网站，根目录如 /www/wwwroot/maccms
- 上传 MacCMS V10 源码
- 浏览器访问 http://你的IP/install.php 完成安装
- 公网使用需在安全组放行 80 / 443 端口
十、方式三：Docker 一键部署
- docker run -d \
- --name maccms \
- -p 7963:80 \
- -e MYSQL_HOST=db \
- -e MYSQL_DATABASE=maccms \
- maccms/maccms10:latest
安装后访问- http://服务器IP:7963/install.php
★ 第四部分：开启 API（自建必做）★
使用公开 API 站点的用户可跳过本节
十一、开启「视频 API」（必须）
- 登录后台：http://你的站点/admin.php
- 进入 系统 → 开放API配置（部分版本：系统 → 采集参数配置 → 视频API）
- 确认设置：
视频API → 开启（关闭后 APP 无法拉取任何数据）
指定播放组 → 留空（留空输出全部播放组）
图片域名 → 留空或填站点域名
接口授权密码 → 留空保存配置
十二、开启「公共 API」（可选，建议开启）
后台 系统 → 开放API配置 → 公共API → 开启
开启后 APP 分类树更准确；不开启也能用，APP 会自动兼容回退。
十三、首页「最新推荐」配置（可选）
APP 首页 最新推荐 读取 MacCMS 推荐等级 level=9 的影片。
- 后台 视频 → 编辑影片 → 推荐 设为 9
- 浏览器核对：http://你的IP:7963/index.php/vod/show/level/9.html
公开 API 站点一般已配置好推荐数据，自建站需自行设置。
十四、API 自检清单
- 视频列表：/api.php/provide/vod/?ac=list&pg=1&pagesize=5 → code=1，有 list
- 视频详情：/api.php/provide/vod/?ac=detail&ids=影片ID → code=1，含封面与播放组
- 分类（可选）：/api.php/type/get_list/ → code=1，有分类树
- 推荐（可选）：/index.php/vod/show/level/9.html → 页面含推荐影片
- 前台首页：/ → 网站正常打开
★ 第五部分：APP 连接与使用 ★
十五、连接 MacCMS（免部署 / 自建通用）
- 设置 → 资源管理
- 填写 站点根地址（公开站或自建 NAS 地址均可）
- 保存配置 → 测试连通性 → 显示 已连接
- 返回首页等待加载
自建局域网示例：
公开 API 示例：
十六、首页内容说明（重点）
连接成功后，首页大致分为三块：
① 最近播放
有观看记录时自动显示，带进度条，点击续播。
② 最新推荐
展示 MacCMS 推荐等级 9 的内容；点「更多」进入完整推荐列表。
公开 API 站点和自建站均支持，取决于站点是否有推荐数据。
③ 分类栏目
- APP 从 MacCMS 读取服务器上的全部分类
- 首次使用默认只在首页展示顶级大类（电影、连续剧、综艺、动漫等），避免首页过长
- 想看更多分类 → 底部 筛选 页浏览全部分类
- 想自定义首页显示 → 设置 → 首页设置 → 首页分类设置
十七、日常使用
浏览首页 — 最近播放、最新推荐、各大类栏目
筛选 — 底部筛选，浏览全站分类与条件筛选
搜索 — 顶部搜索图标
详情页 — 简介、选集、播放源
播放 — 续播、变速、选集、跳过片头片尾
播放器快捷键 — 左右快进快退；OK 暂停/播放；返回退出
★ 第六部分：常见问题 ★
十八、连接与数据相关
Q：提示「请先配置 MacCMS 服务器」？
A：设置里保存有效站点地址。
Q：测试连通性失败？
A：检查地址格式、网络；确认视频 API 已开启。
Q：公开站点连不上？
A：换网络重试，或更换其他公开 API 站点。
Q：已连接但首页无分类？
A：站点无视频数据；或到首页分类设置里开启至少一个分类。
Q：首页只有几个大类？
A：正常现象，默认只显示顶级分类；筛选页可看全部。
Q：最新推荐为空？
A：该站点未配置推荐等级 9 的数据。
Q：有列表但无法播放？
A：播放源失效，换片或换站点。
Q：电视访问不了 NAS？
A：确认同网段；电视浏览器先测 http://NAS_IP:端口
十九、APP 使用相关
Q：搜索 / 筛选无结果？
A：换关键词；确认站点有数据。
Q：跳过片头片尾不生效？
A：播放器 跳过 → 开启开关 → 保存设置。
Q：记忆续播不工作？
A：播放设置里确认「记忆续播功能」已开启。
Q：无法检测更新？
A：手动从 GitHub Releases 下载安装。
★ 第七部分：项目信息与总结 ★
二十、项目信息
应用名称：柠檬影视TV
包名：com.lemon.yingshi.tv
当前版本：v1.0.3（稳定版）
技术栈：Kotlin + Compose for TV + ExoPlayer + Room + Hilt
版本历史：
v1.0.2 — 最新推荐、分阶段加载、筛选页焦点优化
v1.0.1 — MacCMS 分类实时同步、版本检测、焦点崩溃修复
v1.0.0 — MacCMS 影视客户端首发
二十一、适合谁用？
✓ 不想折腾、想 填地址就能看 的盒子用户
✓ NAS 玩家，自建 MacCMS 家庭影视库
✓ 想要 TV 专用客户端、不想用手机版凑合
✓ 喜欢开源、可自己改代码的玩家
二十二、写在最后
柠檬影视TV 用法很简单：
有公开 API 站点 → 填地址就能用；想长期自用 → NAS 自建 MacCMS。
首页默认给你 最新推荐 + 几个大类栏目，够用且不乱；要更多分类，筛选页和首页分类设置里都管够。
欢迎恩山大佬试用反馈！ GitHub 提 Issue 或帖内留言均可。觉得不错帮忙 Star 支持开源～
免责声明：本帖仅分享开源客户端及 MacCMS 使用方法。公开 API 站点为第三方服务，内容与稳定性与本 APP 及作者无关，请用户自行甄别、合法合规使用。本 APP 不内置、不提供任何影视资源。
| 
粤公网安备 44522102000125 增值电信业务经营许可证 粤B2-20192173
发表于 
主题置顶卡
沉默卡
变色卡
楼主
扫一扫，关注易界动态