我写了一个影视 TV 应用：AMUTV 下载与更新指南

AI 摘要

AMUTV 是什么

AMUTV 是我自己写的一个「影视 TV」应用：界面与交互对标电视盒子上的 TVBox / 影视仓，但底层是纯 Web 技术——整个项目 零 npm 依赖，node server.js 一条命令就能跑起来。它同时提供三种形态：

形态	说明
📱 安卓 App	amutv.apk（约 3.2MB），网页资源全内嵌 + 内置 MiniServer，装上电视/盒子后完全独立运行，不依赖电脑
🖥️ 桌面 App	Electron 壳，软解防闪退、崩溃自愈、错误落盘
🌐 浏览器 / PWA	任何设备的浏览器打开即用，支持安装到桌面/主屏幕，UI 骨架离线可用

项目开源在 GitHub：915964222/AMUTV。

功能一览

• 大屏交互：纯黑海报墙主题（Apple TV 风格），胶囊导航、横向海报行、白色焦点环；方向键在卡片间移动焦点、Enter 确认、Esc 返回，遥控器和鼠标双操作都顺手。
• 内容源：支持 URL 订阅或粘贴 TVBox 配置 JSON（单仓 / 多仓），clan:// 按仓库基址解析，源连通性测试（🟢🔴）；多源全网搜索支持拼音首字母（dxt → 大雄兔），结果按速度 / 清晰度排序。
• 自动换源：播放失败或卡顿超 15 秒自动换源（最多 3 次，可关），播放页也能手动挑其他源的同名影片。
• IPTV 直播：m3u / txt 双格式解析，同名频道多线路合并容灾；EPG 节目单（正在播 / 接下来）；45 秒未出画自动切下一线路的看门狗。
• 播放器：HLS 多码率画质锁档 / MP4 直连；倍速 0.5~3x、画面缩放、音轨、内嵌与在线字幕（SubHD 自动下载）；B 站 XML 弹幕 + 弹弹play 接口；片头片尾自动跳过、断点续播；m3u8 广告切片双层过滤。
• 网盘与 NAS：Alist（302 原画直链）、WebDAV、SMB、阿里云盘、夸克直连；网盘视频自动刮削豆瓣海报/评分/简介；蓝光原盘 .m2ts/.ts 流式播放，4K 文件蓝徽章识别。
• 手机遥控：播放器出二维码，手机扫码进入 /remote 遥控页，seek、切集、调音量；还能扫码推送配置直接导入源。

下载与安装

三种方式按需选一种即可：

安卓电视 / 盒子（推荐）

1. 到 GitHub 仓库下载 amutv.apk；
2. U 盘拷贝 APK 插到电视上，用文件管理器安装（电视需先在设置里允许「未知来源」安装）；
3. 打开即用，独立运行不依赖电脑。局域网内其他设备的浏览器访问 http://<电视IP>:9978 也能直接用。

桌面电脑

下载仓库后双击 启动影视TV.bat，Electron 壳会自动拉起内嵌服务器。

浏览器

node server.js
# 打开 http://localhost:9978

局域网内电视、手机浏览器访问 http://<电脑IP>:9978 即可当电视应用用。

添加采集源

「设置」→ 填名称 + 苹果CMS接口地址（如 https://example.com/api.php/provide/vod/）→ 添加后顶栏「播放源」切换。站点不开跨域头时保持代理模式开启即可。直播页同理可添加 m3u / txt 直播源。

更新方法

安卓端

APK 是全量包，更新就是重新下载最新 amutv.apk 覆盖安装，数据（收藏、历史、源配置）保留。覆盖安装后如果闪退，先卸载再装新版。

浏览器 / 桌面端

git pull        # 拉取最新代码
node server.js  # 重启服务即可

PWA 客户端刷新页面后会自动拿到新资源。

常见问题

现象	排查思路
安装时提示「解析包错误」	APK 下载不完整，重新下载
覆盖安装后闪退	卸载旧版后重新安装
搜索无结果	检查采集源是否可用，用顶栏测源按钮确认🟢
播放卡顿	保持自动换源开启，或在播放页手动换源
局域网设备访问不了 9978	检查电脑/电视防火墙是否放行 9978 端口

⚠️ 免责声明：本软件只提供聚合展示功能，所有资源均来自互联网公开内容，软件不参与任何资源的制作、上传、储存与下载等内容。仅供个人学习交流参考，请于安装后 24 小时内自行删除。