Local TV

把 U 盘插上电视,像看有线电视一样看本地视频。

为什么会有这个项目

家里老人想看电视剧。

试过 TVBox 那类直播/点播软件,源不稳定,今天能用明天黑屏,弹个更新提示老人就懵了。试过装播放器自己点 U 盘,文件夹一层套一层,看完一集要退回去选下一集,按错一个键蹦出来的菜单他们看不懂。智能电视的首页全是会员推荐和广告位,真正能用的入口反而最难找。

折腾来折腾去,发现一个事:早年看有线电视,根本没这些问题。开机就有画面,按上下换台,按左右调音量,这一套老人闭着眼睛都会。换台不需要学习,因为本来就没什么可学的。

Local TV 就是照着这个思路做的:

U 盘插上 → 开机 → 自动播放。上下键换剧,左右键换集。没有进度条,没有文件列表,没有"打开方式",没有需要学的东西。 智能电视太不智能,那就干脆做回不智能的样子。

一个文件夹就是一个"频道",文件夹里的视频就是这个频道的"剧集"。U 盘根目录可以这样组织:

U盘/
├── 亮剑/
│   ├── 第01集.mp4
│   ├── 第02集.mp4
│   └── poster.jpg   ← 可选,作为该频道的封面
├── 父母爱情/
│   ├── S01E01.mkv
│   └── S01E02.mkv
└── 人世间/
    ├── 01.mp4
    └── 02.mp4

放进去,插上,开机。剩下的交给遥控器。

它能干什么

像电视一样

• 开机自动播放上次看到的位置,断电也不会丢
• 没有进度条,没有快进。播完这一集自动播下一集,这一部播完自动跳下一部
• 上下换剧、左右换集,OK 键调出频道面板,菜单键进设置,就这些

对 U 盘友好

• 两阶段扫描:插上 U 盘几乎立刻就能开始看,后台再慢慢补全剧集时长信息
• 文件名格式很宽容:S01E05、第05集、圈码 ①②③、纯数字开头都认。一集多段的 第01-03集.mp4 当作一条处理
• 自动识别文件夹里的 poster.jpg / poster.png 当封面,没有就抓视频帧
• USB 插拔有 3 秒防抖,U 盘还没就绪也会等最多 60 秒再重试

别的就没了

• 不联网,不上传,不统计,没广告,不检查更新
• 没有账号系统,没有云同步,没有"推荐内容",没有任何花里胡哨的东西

怎么用

需要一台装了 Android TV 的设备(电视盒子、智能电视都行),有 USB 接口,API 21 以上。

直接装 APK:

./gradlew :app:assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk

需要 JDK 17 和 Android SDK(目标 API 34,最低 API 21)。

遥控器

按键	功能
⬆	上一部剧(从第 1 集开始)
⬇	下一部剧(从第 1 集开始)
⬅	上一集(第 1 集时停留)
➡	下一集(最后一集回到第 1 集)
OK	调出频道面板
菜单	进入设置

如果觉得上下方向反了,可以在设置里反转。

致谢

基于 mytv-android 二次开发,感谢原作者。

License

MIT,详见 LICENSE。