# LibreTV-App
**Repository Path**: giteevip2018_admin/LibreTV-App
## Basic Information
- **Project Name**: LibreTV-App
- **Description**: LibreTV-App - 镜像自 wangshaojie/LibreTV-App
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-17
- **Last Updated**: 2026-11-17
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 静观 TV
### 把 LibreTV 装进你的手机和电视 —— 原生客户端、免安装、数据只留在本机
[](https://github.com/wangshaojie/LibreTV-App/stargazers)
[](https://github.com/wangshaojie/LibreTV-App/network/members)
[](https://github.com/wangshaojie/LibreTV-App/releases/latest)
[](https://github.com/wangshaojie/LibreTV-App/releases)
[](https://github.com/wangshaojie/LibreTV-App/releases)
[](LICENSE)
[**下载 Android APK**](https://github.com/wangshaojie/LibreTV-App/releases/download/android-v2.0.24/LibreTV-App-Android-v2.0.24-universal-android5.apk) · [**下载 Windows 免安装版(7z · 110 MB)**](https://github.com/wangshaojie/LibreTV-App/releases/download/v2.19.3-desktop.11/LibreTV-App-v2.19.3-desktop.11-Windows-x64.7z) · [**Windows ZIP · 159 MB**](https://github.com/wangshaojie/LibreTV-App/releases/download/v2.19.3-desktop.11/LibreTV-App-v2.19.3-desktop.11-Windows-x64.zip)
---
## 这是什么
**静观 TV** 是基于 [LibreSpark/LibreTV](https://github.com/LibreSpark/LibreTV) 的**非官方跨平台客户端**。
原版是一个需要自己用 Docker 部署的网页应用。我们把它做成了两个可以直接用的东西:
- **Windows 免安装版** —— 绿色程序目录 + 数据目录,解压即用,不需要装 Node.js、Docker 或管理员权限。
- **Android 原生客户端** —— 一个 APK,手机触屏和电视遥控器都是原生手感,最低支持 Android 5.0 的老电视。
内置 **9 个点播源、9 个直播源**,开箱即用。你的片源配置、收藏和观看记录**全部保存在自己的设备上**——没有账号,没有遥测,不投放广告。
## 和原版有什么不同
| | 静观 TV | 原版 LibreTV |
| --- | --- | --- |
| **Android** | 原生 APK,手机触屏 + 电视遥控器,最低 Android 5.0 | 无官方客户端 |
| **Windows** | 绿色目录分发,解压即用 | 需自行 Docker 部署 |
| **界面** | 两端同一套浅色主题,自绘弹框 | 网页版 |
| **片源更新** | 官方清单远程合并,源坏了不用手动改 | 手动编辑配置 |
| **片源体检** | Windows 与 Android 原生客户端内均可批量测活 | 仅网页端 |
| **网络** | Windows 版自动跟随系统代理 / PAC | 需自行配置代理 |
| **隐私** | 数据全在本机,无账号、无遥测 | 自托管,配置项更多 |
## 亮点
🎨 **浅色单主题,电视和手机同一个样子** —— 暖白页面底配单一青绿强调色,界面走扁平风:不用阴影、不用描边、不用大圆角、不用渐变,层次只靠纯色块的深浅(页面底 → 面板底 → 卡片 → 标签)区分。弹框全部自绘,不再出现系统默认的蓝白样式;播放页保持深色沉浸,看画面时不刺眼。
📱 **手机上点一下就有反应** —— 手机端此前有个老毛病:第一次点击只让控件亮一下,第二次才真的执行。按设备类型分流之后,手机点一下就执行,电视遥控器的行为完全没变。
🎬 **详情页里直接换片源** —— 同一部影片在多个源都有时,详情页下方就是「片源 · N 个可用」一行,点一下即切换,线路与剧集立刻跟着换,不必退回搜索结果重选。剧集不跨源合并,避免不同源集数对不上。
📱 **播放页一键全屏** —— 手机上点「全屏」切横屏并收起所有控件,再点一次画面切回竖屏,返回键也能先退全屏。
🔄 **官方片源清单远程维护** —— 启动时自动拉取项目维护的源清单并与本地配置合并。**合并以你的意图为准**:新增的源自动补入,你手动停用的源保持停用,你自己添加的源完全不受影响,你删除过的官方源不会被加回。清单地址由维护者控制,普通用户只能读取。
🩺 **批量测活** —— 一次检查所有片源或所有直播频道,可随时停止、筛选异常并重测,结果保存在本机。
📺 **为老电视专门修过** —— 早期电视只有硬件解码器,切台时销毁重建解码器会导致固件 native 崩溃、整台电视「只有声音没有画面」。我们改为复用同一个播放器实例,并修复了老系统 IPv6 路由缺失导致连不上站点的问题。
🔒 **隐私干净** —— 不请求通讯录、定位、摄像头或全盘存储权限;不集成广告、统计或遥测 SDK。
## 下载
### Windows 免安装版
**[⬇ 下载 Windows 7z 包](https://github.com/wangshaojie/LibreTV-App/releases/download/v2.19.3-desktop.11/LibreTV-App-v2.19.3-desktop.11-Windows-x64.7z)** · **约 110 MB** · **[⬇ 下载 Windows ZIP 包](https://github.com/wangshaojie/LibreTV-App/releases/download/v2.19.3-desktop.11/LibreTV-App-v2.19.3-desktop.11-Windows-x64.zip)** · **约 159 MB** · [查看所有版本](https://github.com/wangshaojie/LibreTV-App/releases)
版本 `2.19.3-desktop.11` · Windows 10 / 11 x64 · 解压后打开 `LibreTV-App` 文件夹,双击 `静观TV.exe` 即可运行
两个包内容完全相同,只是压缩方式不同:**7z 包小约三分之一**,Windows 11 22H2 以后资源管理器可直接解压;Windows 10 或习惯 ZIP 的用户下载 ZIP 包即可。
ZIP 内附发布者的数据快照(含初始源配置与设置)。升级时用新版文件夹里的程序文件覆盖旧文件夹(`LibreTV-Data` 除外),即可保留你自己的数据。
> **2.19.2-desktop.6 起改为目录分发**:早先的单文件 EXE 每次启动都要把约 460 MB 运行时重新解压到临时目录并被杀毒软件逐个扫描,窗口要等近 30 秒;改为目录分发后启动约 **1 秒**。功能完全一致。
> **请认准最新版**:Android **2.0.24**、Windows **2.19.3-desktop.11**。更早的 Android 版本(2.0.10)存在片源搜索失效的问题,不建议使用;其余旧版功能可用,但少了清单多镜像、老系统 TLS 1.2 支持、手机端触控修复与播放全屏。
### Android 通用版
**[⬇ 下载 Android APK](https://github.com/wangshaojie/LibreTV-App/releases/download/android-v2.0.24/LibreTV-App-Android-v2.0.24-universal-android5.apk)** · [查看所有版本](https://github.com/wangshaojie/LibreTV-App/releases)
版本 `2.0.24` · 最低 Android 5.0 · 手机与 Android TV 通用 · 只有一个安装包
> 手机直接下载安装;电视可用 U 盘或电视文件管理器打开 APK。两端均为**同一安装包覆盖升级**,保留源配置、收藏和观看记录,无需先卸载。
## 界面预览
### Android TV
**首页:电影 / 剧集海报、最近观看与遥控器导航(浅色主题,焦点用强调色实心块)**

**直播频道:分组、搜索、批量测活与可连接筛选**

**直播播放页:全屏沉浸式,观看时不显示任何按钮或标题**

**播放页控制面板:进度条独占一行,底部一排图标键;遥控器上下键在两行之间搬焦点、左右键逐个走过每个功能键,无操作约 8 秒后自动淡出**

### Windows
浅色主题下的首页与聚合搜索、直播频道分组、详情页直接换源。
## 快速上手
**Windows**
1. 下载 ZIP 包,**完整解压**到有写入权限的文件夹。
2. 打开解压出来的 `LibreTV-App` 文件夹,双击 `静观TV.exe`(约 1 秒启动)。
3. 在「设置 → 源管理」中管理自己的片源:M3U 播放列表加到**直播源**,Apple CMS JSON API 加到**点播源**。
4. 首页用于影片搜索,顶部「直播」用于浏览 M3U 频道和分组。
**Android**
1. 下载 APK 并安装(电视需允许「安装未知来源应用」)。
2. 首页点海报即可查找片源;「点播」页全源搜索同名影片。
3. 「我的 → 源管理」管理片源,「直播」浏览频道;遥控器方向键移动焦点、确定键选择。
## 常见问题
**Q:需要账号或服务器吗?**
不需要。Windows 版内置本地服务,Android 版完全在设备上运行。数据都存在你自己的设备里。
**Q:为什么我的老电视连不上某些源?**
部分片源站点已不可用,或需要代理——这是站点和网络的状况,不是应用的问题。片源之间互不影响:某个源测不通就只是这个源不可用,其他源照常搜索。用「源管理 → 全部测活」检测一遍,把连不上的关掉即可。2.0.13 起修复了老系统 IPv6 路由缺失导致连不上站点的问题(自建 IPv4 通道并保留正确的 SNI 与证书校验),2.0.14 起官方片源清单改为多地址镜像,主地址拉不到会自动换下一个,电视这类没有代理的设备也能持续收到清单更新。
**Q:手机上「点了没反应」怎么办?**
2.0.15 已修复。此前手机端第一次点击只会让控件亮一下、第二次才真的执行(控件可以在触摸模式下获取焦点,框架把第一次点击拿去「聚焦」了)。现在按设备类型分流:手机点一下就执行,电视遥控器行为不变。如果还在用 2.0.14 或更早的版本,请下载 2.0.15 覆盖安装。
**Q:播放的时候怎么有广告?**
那是**片源站自己插的**,不是本应用加的——本应用既不投放广告,也不从中获利,更不参与片源站的任何分成。不同片源的干净程度不一样,介意的话在「源管理」里换一个源,或用测活把带广告、不可用的源关掉。
**Q:可以加自己的源吗?**
可以。M3U 播放列表填「直播源」,Apple CMS JSON API 填「点播源」,两个端都支持。
**Q:Windows 版怎么升级?**
关闭旧版,用新版 `LibreTV-App` 文件夹里的程序文件覆盖旧文件夹中除 `LibreTV-Data` 以外的全部内容。不要用发布包里的示例数据覆盖你已经使用的数据目录。
更多细节见 [Android 说明](android/README.md) · [Windows 说明](desktop/README.md)
## 参与共建
这是我们最想看到的一件事 ⭐
- **点个 Star** —— 让更多人知道这个项目,也让更多电视机能用上。
- **报问题** —— 把你遇到的老电视型号、报错和片源失效情况告诉我们,这类问题只有真机能复现。
- **提 PR** —— 欢迎提交修复与改进,尤其欢迎补充片源解析、播放器体验和电视端适配。
## 从源码构建
**Windows 版**(需要 Node.js 22 或更新的受支持版本):
```powershell
npm ci
npm run build
cd desktop
npm ci
npm run dist
```
`npm run build` 生成网页产物,`desktop` 下的 `npm run dist` 会先调用它再打出 Electron 程序目录。
**Android 版**(需要 JDK 17、Gradle 8.9、Android SDK 35):
```sh
gradle -p android testDebugUnitTest assembleDebug
```
发布用签名 APK 由 GitHub Actions 构建,签名密钥不进入仓库也不进入下载附件。更多开发说明见 [desktop/README.md](desktop/README.md) 与 [android/README.md](android/README.md)。
## 上游与许可
本项目是**非官方衍生项目**,上游项目及原作者的贡献和署名予以保留。
- 上游项目:[LibreSpark/LibreTV](https://github.com/LibreSpark/LibreTV) · 版本 `2.19.2` · 基础提交 `dd1c744c40d60ee553bd9f7eb3df55dd79a8f7dc`
- 原项目说明:[README.upstream.md](README.upstream.md)
- 本仓库新增:Windows 便携封装、系统代理网络适配、Android 手机 / TV 原生客户端、官方片源清单远程更新、批量测活、构建 / 验证脚本和发布文档
LibreTV 和本项目按 **AGPL-3.0-or-later** 提供,完整条款见 [LICENSE](LICENSE)。Electron、Chromium 及其他第三方组件遵循各自许可证。
> 本项目提供客户端和播放功能,**不制作或托管影视内容**。请仅使用有权访问的数据源和内容。
## 项目性质
静观 TV 目前**完全出于个人爱好**而做:免费、开源、不投放广告、不做收费或任何商业化,也不收集任何用户数据。
需要说明的是,部分片源在播放过程中会插入广告——**那是源站自身的行为,与本项目无关**;本项目不对片源站的内容和广告负责,也无法替你过滤它们。遇到带广告的源,直接换一个或关掉即可。