free-my-tv (无广告智能电视桌面)
6,245
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
Java
语言
创建时间
最近更新
项目能做什么
适用于 Google TV、LG 及三星电视的无广告纯净桌面,运行流畅无推广干扰,支持一键还原。
来源:AI 基于仓库事实生成
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
# Free My TV 中文使用说明
Free My TV 是一款开源、轻量且无广告的电视桌面替代应用,支持 Google TV / Android TV、LG webOS 以及 Samsung Tizen。
## 项目简介
Free My TV 旨在取代原厂电视系统中臃肿且充满广告的桌面。它通过玻璃拟态风格展示用户常用的流媒体应用,基于用户自选服务推荐热门影视,并提供即时天气与加密货币行情。项目不需要 Root 权限,不卸载任何系统应用,支持一键恢复官方桌面。
## 核心功能
- **彻底无广告**:无任何赞助推荐行、横幅或自动播放推广视频。
- **自定义应用栏**:玻璃材质应用底栏,可直接在电视上选择常用应用并调整排序。
- **热门内容推荐(非赞助)**:根据已安装应用与自选流媒体服务,每小时推荐 3-6 部当季热门内容。支持电影/电视剧标签页分类,Google TV 还支持接入个人 Plex 媒体库。
- **继续观看**(Google TV / Android TV):在桌面顶部展示各应用未看完的内容及进度,点击即可继续播放。
- **TMDB 密钥绑定**:支持手机扫码快速粘贴 TMDB API Key(LG / 三星可使用遥控器输入)。
- **实用抽屉**:一键查看逐小时/未来 5 天天气、日落日出时间、实时加密货币价格;LG / 三星设备额外支持 2 小时降雨、UV 指数与空气质量。
- **状态栏与鼠标支持**:显示 Wi-Fi/有线网络、蓝牙音频及 USB 设备状态;支持普通鼠标或飞鼠遥控器操作。
- **日夜模式与屏保**:跟随城市实际日落时间自动切换明暗模式;配备防 OLED 烧屏的动态时钟屏保与推荐海报屏保。
- **轻量极速**:针对电视芯片深度优化,稳定 60 fps,内存占用仅约 96 MB(相比默认桌面的 242 MB 降低约 60%)。
## 适合谁用
- 厌恶电视开机广告、横幅推广的 Google TV、Android TV、LG webOS 及 Samsung Tizen 电视用户。
- 追求极致精简、流畅桌面体验的家庭影音爱好者。
## 安装步骤
安装耗时约 10 分钟。**前提条件**:需准备一台 Google TV 或 Android TV(Android 8+ 版本),且电脑与电视处于同一局域网(Wi-Fi)下。APK 必须安装到电视端。
### 方式一:使用 AI 助手自动化安装
1. **电视端开启开发者模式**:
- 前往 `Settings`(设置)→ `System`(系统)→ `About`(关于),连续点击 **Android TV OS build** 7 次。
- 返回进入 `Settings` → `System` → `Developer options`(开发者选项),开启 **USB debugging**(USB 调试)。
- 记录电视的局域网 IP 地址(路径:`Settings` → `Network & Internet`)。
2. **电脑端执行**:
- 打开 AI 编程助手(如 Claude Code、Codex 等),输入以下指令(请将 IP 和城市替换为你自己的实际信息):
> Install Free My TV (github.com/simbasjungles/free-my-tv) on my TV at 192.168.1.50. I live in Lisbon.
3. **电视端授权**:
- 打开 *Free My TV* 应用,依次选择 *Home Screen* → *Free My TV*。
- 当电视弹出 *Allow USB debugging?*(允许 USB 调试?)提示时,勾选 *Always allow*(始终允许)并确认。
### 方式二:使用预编译 APK(通过 adb)
除 `adb` 工具外无需安装其他编译依赖:
1. 前往仓库的 Releases 页面下载最新 APK。
2. 电视端按上述步骤开启 **USB debugging** 并获取 IP。
3. 电脑端使用 `adb` 命令连接电视并安装:
```bash
adb connect <电视IP>
adb install <下载的APK文件路径>
```
4. 安装完成后,需在电视端手动配置 TMDB 密钥以获取影视推荐。
*(注:针对 LG webOS、Samsung Tizen 及源码手动编译的具体步骤,原文未完全展开,请查看原仓库)*
## 配置说明
所有配置均可直接在电视端设置完成:
- **TMDB 密钥配置**:进入 *Home Settings* → *TMDB key*,屏幕会生成二维码,使用手机扫码即可直接粘贴你的 TMDB API Key。
- **内容源设置**:进入 *Home Settings*,可调整城市、温度单位、主题、推荐条目数量(最高 6 个)以及绑定的流媒体服务。
- **顶部显示**:在 *Home Settings* → *Top of the screen* 中,可将顶部切换为“继续观看”、“大时钟”或“推荐内容”。
- **单键还原系统桌面**:应用内设置提供一键切换选项,可随时无缝切回电视出厂自带的默认桌面。
## 常见问题
- **手机安装后无法设置?**
本应用专为电视端设计,手机端安装后仅提示说明,无法作为手机桌面生效。
- **新装 APK 没有影视推荐?**
官方 Release 预编译包默认不包含 TMDB Key,请在电视端 *Home Settings* → *TMDB key* 中绑定自己的 API 密钥。
- **LG / 三星电视如何安装?**
此部分原文截断未说明,请查看原仓库文档对应章节。
原始 README 摘录(英文原文,节选前 3000 字符)
<div align="center"> <img src="docs/assets/icon-512.png" width="96" alt=""> # Free My TV **A fast, ad-free home screen for Google TV, LG and Samsung TVs.** Trending picks from your own apps, the weather at a glance, and a look that follows the sunset.<br> Open source. Built with Claude Code. One button to undo. [**freemytv.io**](https://freemytv.io) · [Install](#install) · [LG TVs](#lg-tvs-webos) · [Samsung TVs](#samsung-tvs-tizen) · [Any TV](#any-tv) · [Make it yours](#make-it-yours) <img src=".github/preview.webp" width="880" alt="The Free My TV home screen: a glass shelf of apps, trending picks, and a drawer with the weather and crypto prices"> </div> ## What you get - **No ads.** No sponsored rows, banners or autoplaying promos. Not one. - **Your apps, front and center.** The streaming apps you actually use, on a glass shelf. Pick them and their order right on the TV. - **Trending, not sponsored.** Three fresh picks every hour (up to six, in Home Settings) from what's trending this week and the latest releases, only from apps you already have, and from the services you choose. The focused one opens wide and the others show their posters. Movies and Shows get their own tabs, and on Google TV your own [Plex library](#your-plex-library-optional) can join in. - **Continue Watching** (Google TV and Android TV). *Home Settings* → *Top of the screen* puts what you left halfway in your apps on top, with its progress, and OK picks it up in its app. Or a big clock, or the picks. - **Your TMDB key from your phone.** *Home Settings* → *TMDB key* shows a QR code: scan it and paste the key. On LG and Samsung, type it with the remote. - **Weather and markets, one press away.** The hour-by-hour forecast (or the next 5 days), sunrise and sunset, and live crypto prices; on LG and Samsung, also rain in the next two hours, the UV index and the air quality. - **Live TV or your box on HDMI, one press away** (LG and Samsung). *Home Settings* → *Live TV button* picks what the first top button opens: Live TV, as before, or one of the TV's HDMI inputs, shown under the name you gave the input on the TV when it has one. On a TV with no antenna, *Home Settings* → *Live TV* takes its tile out of the inputs. - **What's playing.** Music, a podcast or the radio going on in the background shows on the home screen and the screensaver: the title, the artist and the app, from any app that tells Android what it plays (*Home Settings*, off until you turn it on). - **The status at a glance, and a mouse** (Google TV and Android TV). *Home Settings* → *Status icons* puts Wi-Fi or Ethernet, Bluetooth audio and a USB drive at the top of the home screen; off, nothing listens for them. A mouse or an air-mouse remote works too: hover moves the focus, the wheel scrolls, a click picks. - **Light by day, dark by night.** It follows your city's real sunset, the way your phone does. - **A screensaver to match.** Full-screen photos of the picks with a big glass clock. On LG and Samsung阅读完整原文
商业机会分析 AI 生成
跨设备配置同步与移动端遥控/伴侣应用 (Pro Cloud Sync)
| 产品构想 | 针对多电视家庭或不愿通过遥控器复杂配置的用户,提供移动端/Web管理后台,支持一键分发应用排布、TMDB Key、Plex源及自选照片。 |
| 核心功能 | 配置云端热同步、手机端快速排序与应用隐藏、自选照片批量无线快传至电视壁纸、家庭多成员桌面Profile切换。 |
| 目标用户 | 拥有多台电视的高级用户、家庭影音极客。 |
| 难度/周期 | 中等 · 1-2个月 · 成本:极低(轻量云服务器与数据库存储) |
| 收费模式 | 增值订阅制(如 $2.99/月 或 $19.99 终身买断制)。 |
| 竞争风险 | 电视端权限限制及系统升级可能影响桌面自启动;用户可能倾向单机手动设置而不愿为同步买单。 |
| 依据 | 已验证事实 |
B端商用/民宿轻量展示系统 (Free My TV for Business)
| 产品构想 | 将极简、无广告、自带天气和输入源切换的特性打包为民宿、酒店、联合办公空间及零售门店定制的数字标牌/电视系统。 |
| 核心功能 | 品牌Logo与欢迎语定制、锁定设置与防篡改PIN码、指定HDMI源开机自启、展示本地旅游推荐或会议日程卡片。 |
| 目标用户 | Airbnb房东、精品酒店、会客室管理员、智能家居集成商。 |
| 难度/周期 | 中等 · 2-3个月 · 成本:低(基础SaaS平台与远程设备管理) |
| 收费模式 | 按设备月付/年付License授权(如 $3-5/台/月)。 |
| 竞争风险 | LG webOS与三星Tizen的企业级侧载与常驻策略可能受到厂商系统安全策略收紧的限制。 |
| 依据 | AI推测 |
高级内容源增强插件与私有元数据服务 (Media Power Pack)
| 产品构想 | 为高级影音玩家提供深度内容聚合,超越基础TMDB的推荐体验,免除用户自备API Key与自建刮削的繁琐门槛。 |
| 核心功能 | 开箱即用的高并发剧集更新追踪、多流媒体服务跨平台深层跳转协议适配、Trakt.tv无缝双向进度同步、4K精选动态艺术画廊屏保。 |
| 目标用户 | 重度追剧人群、Plex/Emby重度用户、多流媒体订阅者。 |
| 难度/周期 | 较高 · 2-3个月 · 成本:中等(内容元数据聚合、CDN带宽及版权合规审查) |
| 收费模式 | 订阅制(如 $4.99/月 提供高级数据整合与高分辨率动态屏保流)。 |
| 竞争风险 | 各流媒体平台Deeplink协议变更失效;元数据与海报分发版权合规风险。 |
| 依据 | 尚需验证的假设 |
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| Gathin23/cleanyourtv | 通过 Wi-Fi 精简 Android/Google TV 并提供 Apple TV 风格桌面。 | 55,568 | Python |
| yuliskov/SmartTube | 专为 Android TV 打造、可按自定义规则浏览内容的媒体客户端。 | 36,152 | Java |
| youhunwl/TVAPP | 汇总各类 Android TV 盒子应用与影视壳配置源的资源集合。 | 27,710 | JavaScript |
| pengchujin/aerial-tv | 参照 tvOS 设计、无广告且开机自启的开源 Android TV 桌面。 | 10,971 | Kotlin |
| chrisbanes/tivi | 连接 trakt.tv 的 Android 剧集追踪与追剧记录应用。 | 6,716 | Kotlin |
| czy0729/Bangumi | 无广告、专为移动端重构的第三方 bgm.tv 追番记录客户端。 | 6,232 | TypeScript |
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。
项目优势与风险
| 技术成熟度 | 创建于 ,最近推送 ,发布过 4 个 Release |
| 社区活跃 | Star 6,245 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
快速开始(以仓库 README 为准)
git clone https://github.com/simbasjungles/free-my-tv.git cd free-my-tv # 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。