Repository navigation
Releases
LibreTV-fnOS v1.0.14(默认源修复)
LibreTV-fnOS v1.0.14(默认源修复)
修复
1.0.13 及更早版本存在一个问题:全新安装时写入的默认采集源来自 cmd/install_callback(以及 cmd/main、
cmd/upgrade_callback 的内置兜底模板),这几处硬编码的仍是旧 4 个源(电影天堂 / 量子 / 如意 / 优质)。
这些域名目前已被 DNS 污染/阻断,导致新装机器搜索为空、同步全部 fetch failed。
1.0.14 起:
- 全新安装:
install_callback与main的默认配置模板统一写入当前可用源
(最大资源 / 无尽资源 / 非凡资源 / 猫眼资源); - 升级迁移:
upgrade_callback在升级时把config.sources中 URL 仍为旧默认源的条目就地替换为可用源
(保留env_*key,浏览器端已选中的源与健康度继续有效;用户自定义源不动); - 已升级到 1.0.13 但搜索为空的机器:安装本版即可自动修复,无需手动改
config.json。
1.0.13 的换源迁移、已入库条目管理、媒体库匹配修复等功能保持不变。
安装包
| 文件 | 用途 | SHA256 |
|---|---|---|
libretv-1.0.14.fpk |
应用中心手动安装包(社区版,OTA 默认开启) | 3b7a9d2c30d0c83e6c4c4641263584d071d0effb41cf742401ba71ecd9bb6262 |
libretv-update-1.0.14.tar.gz |
应用内 OTA 载荷(1.0.13 → 1.0.14) | 6cf7e1b0a1e7912540d09cbcd60081c869e5a242f93fc37d61b8d7b2e0d251a9 |
升级方式
- 应用内 OTA(1.0.11+):打开 LibreTV → 顶部「更新 v1.0.14」→ 一键更新(保留配置/索引/STRM);
- 应用中心手动安装:下载
libretv-1.0.14.fpk→ 应用中心 → 手动安装(升级保留var/,并触发上面的默认源迁移)。
若暂时无法升级:可手动把
/vol2/@appdata/libretv/config.json的sources改为可用源后重启应用。
LibreTV-fnOS v1.0.13(换源迁移)
⚠️ 本版本存在默认源问题:全新安装会写入已被墙的旧默认源(电影天堂/量子/如意/优质),导致新装机器搜索为空。请改用 v1.0.14(升级会自动把旧默认源替换为可用源)。
LibreTV-fnOS v1.0.13(换源迁移)
变更
1.0.13
- 换源迁移:采集源被替换或网络不可达后,已入库条目会自动按当前预置源搜索同名剧集,
用原title/year原地重写 STRM(文件名、目录完全不变,飞牛影视条目与播放进度保留),
索引切换到新源,后续同步与追更改走新源;
找不到同名、集数差异过大(>25% 且 >3 集)、新源条目已存在时自动跳过,不删除、不覆盖现有文件; - 设置页「换源迁移」按钮:手动触发
action=migrate,任务结果给出migrated/skipped/failed; - 预置采集源更新:改为国内可访问的最大资源 / 无尽资源 / 非凡资源 / 猫眼资源;
- Clash 直连规则补充无尽资源 CDN(
ppqrrs.com)。
1.0.12
- 修复媒体库匹配降级:新版影视
mediadb/list不再返回dir_list,引擎自动回退旧端点mdb/list补齐目录,定向扫描恢复; - 尊重手动删除:在飞牛影视里删掉整部剧(资源目录消失)后,同步移除索引且不再补写(
config.respectManualRemoval); - 已入库条目列表与「移除」:设置 → 媒体库可查看全部条目并逐条移除(共享
library-remove,MCPremove_from_library复用同一套逻辑)。
安装包
| 文件 | 用途 | SHA256 |
|---|---|---|
libretv-1.0.13.fpk |
应用中心手动安装包(社区版,OTA 默认开启) | 4f31e6cff236d7ec54f66e7ecd275b4c5fa2b0c89708acad91bfb60b9225f48c |
libretv-update-1.0.13.tar.gz |
应用内 OTA 载荷(1.0.11/1.0.12 → 1.0.13) | d451fd111f23e6b009613e6fe4fcd342b69af8ac2135c70540fa310389e49516 |
升级方式
- 应用内 OTA(1.0.11 及以上):打开 LibreTV,顶部出现「更新 v1.0.13」后一键更新(保留配置、索引与 STRM);
- 应用中心手动安装:下载
libretv-1.0.13.fpk,应用中心 → 手动安装(升级保留var/数据)。
换源迁移默认开启(同步时自动执行);可在
var/config.json设"migrateOnSourceChange": false关闭自动迁移,手动按钮仍可用。
LibreTV-fnOS v1.0.11(商店送审准备)
LibreTV-fnOS v1.0.11(应用商店送审准备)
变更
- 8091 影视代理增加登录鉴权:复用 LibreTV 的
ltv_session会话,未登录访问跳回 8090 登录页;满足“监听端口必须有自己的鉴权机制”的上架要求; - Manifest 完善:真实维护者/发布者、GitHub 地址、
changelog,移除废弃arch字段; - 商店送审版(store edition)默认关闭应用内 OTA:更新走应用中心;社区版保持 OTA;
- 新增 隐私说明;
- 自愈看护(1.0.10)与自动追更/空目录回收(1.0.9)保持不变。
安装包
| 文件 | 用途 | SHA256 |
|---|---|---|
libretv-1.0.11.fpk |
社区版(OTA 默认开启) | f2518799466e24875b4ebe67392a9a6dec4a8741140cebc60731b024ec3ba036 |
libretv-update-1.0.11.tar.gz |
社区版 OTA 载荷(1.0.10 → 1.0.11) | 3e5244c6ba775c77e9b579ce208c2847873f9e003637877c59c66d1af37f57d0 |
应用商店送审使用单独构建的 store edition:
libretv-1.0.11-store.fpk
(SHA25605f3cee5cb40bf4a4bdf68f16bb3f636fc4e5f854a57a5df3dad78941f59e2b9),
与社区版功能一致,仅默认关闭应用内 OTA。
验证
- 8091 未登录:302 → 8090;登录后 200;
- 8090 密码登录、8092 MCP Token、8093 仅 127.0.0.1;
- 自愈看护进程正常;配置/索引/STRM 数据保留。
LibreTV-fnOS v1.0.10(自愈看护)
LibreTV-fnOS v1.0.10(自愈看护)
针对“LibreTV 偶尔自己停用、需要手动启动”的问题,新增 watchdog 自愈机制:
start.js启动时派生一个脱离的watchdog.js看护进程;- Node 进程异常退出(崩溃、被 OOM kill、被强杀)后,看护进程自动重新拉起应用;
- 重启后自动更新
app.pid,应用中心停止/启动仍然正常; - 正常停止(应用中心停止、OTA 重启)时看护进程通过 stop 标记一起退出,不会把应用“复活”;
- 重启退避 5s → 10s → 20s → 60s,稳定运行 5 分钟后重置;
- 日志:
var/watchdog.log(看护/重启原因、退出码、信号、运行时长),应用日志继续写app.log; - 该机制在
server/载荷内,可随 OTA 自动更新,无需改cmd/main。
安装包
| 文件 | 用途 | SHA256 |
|---|---|---|
libretv-1.0.10.fpk |
全新安装 / 手动升级 | 9a7f77d7b357a812e1b754ca498511683d9f17d097817cae356476ceca841eb9 |
libretv-update-1.0.10.tar.gz |
应用内 OTA 载荷(1.0.9 → 1.0.10) | 531f374c2d597768cf86e166a5adcfce52556bc23d260e77c100163e6437776a |
验证
- 强杀 Node(
kill -9)后 1 秒内自动恢复,端口 8090/8091/8092 正常; - 应用中心停止后 8 秒确认无进程复活,再次启动正常;
- 配置、STRM 索引、媒体库数据均不受影响。
LibreTV-fnOS v1.0.9(自动追更 + 空目录回收)
LibreTV-fnOS v1.0.9(自动追更 + 空目录回收)
新增 / 增强
1. 自动追更
- 6 小时同步(可在设置中调为 1–168 小时)会重新拉取每个已入库条目的详情;
- 源站新增剧集(如 9 集 → 30 集)时,自动在对应
Season NN目录补写新增集的 STRM,并触发飞牛影视扫描; - 若本地 STRM 被误删但源站 URL 未变,同步时自动补齐缺失文件;
- 同步结果新增
episodesAdded/filesRestored统计。
2. 空资源目录回收
- 每 5 分钟扫描一次
strmdata第一层资源目录;目录内 0 个.strm且超过 5 分钟宽限期 → 视为已在媒体库删除; - 递归删除整个资源目录(含 nfo、海报、字幕等),并移除索引中的相关条目,触发飞牛影视刷新;
- 宽限期避免与“加入媒体库”任务竞争;可配置:
cleanupEmptyDirs: false关闭;emptyDirGraceMinutes: 10调整宽限分钟数。
安装包
| 文件 | 用途 | SHA256 |
|---|---|---|
libretv-1.0.9.fpk |
全新安装 / 手动升级 | 0e8d08cc39fdfecc0808bd8cfe91225078c51dde3040718f36db7b86f2f8c5d0 |
libretv-update-1.0.9.tar.gz |
应用内 OTA 载荷(1.0.8 → 1.0.9) | 170c2e9fa15d42c96a447121801b52f5bf9dcbffc60780600c0a1c832108909c |
1.0.8 用户可直接在页面点「更新 v1.0.9」完成 OTA。
验证
- 引擎测试 85 个全部通过(新增:追更、缺失补齐、空目录回收、宽限期);
- 追更逻辑:URL 列表变化 → 重建计划并只统计新增文件;URL 未变但文件缺失 → 自动补写。
LibreTV-fnOS v1.0.8(MCP 按目录删除)
LibreTV-fnOS v1.0.8(MCP 资源目录删除)
MCP 删除语义调整:按资源目录删除,与手动管理文件夹一致。
- 删除整部剧/电影:递归删除
strmdata/<片名 (年份)>整个目录(含海报、nfo、字幕等所有文件); - 只删某一季:传
season(如season:1)只删除该季目录(Season 01),其它季保留; - 同步清理
strm-index.json中相关条目(多季条目按季裁剪),并触发飞牛影视刷新; dryRun=true可预览将删除的目录与文件数;all=true用于同名多目录确认。
安装包
| 文件 | 用途 | SHA256 |
|---|---|---|
libretv-1.0.8.fpk |
全新安装 / 手动升级 | cc7c539d0eabc81c1c94c6fd30496b69fa9dc6460849a1629d89f963e4fd8060 |
libretv-update-1.0.8.tar.gz |
应用内 OTA 载荷(1.0.7 → 1.0.8) | 336d2eff01de0ffbe57bad20464b7d1ee0a7703439ff6b0a9d3f7de2699ba304 |
1.0.7 用户可直接在页面点「更新 v1.0.8」完成 OTA。
MCP 示例
{"name":"remove_from_library","arguments":{"title":"庆余年"}}
// 删除 strmdata/庆余年 (2019) 整个目录
{"name":"remove_from_library","arguments":{"title":"庆余年","season":1}}
// 只删 Season 01,Season 02 保留
{"name":"remove_from_library","arguments":{"title":"庆余年","dryRun":true}}
// 只预览,不删除兼容性
- 添加逻辑与手动「加入媒体库」完全一致(同队列、同引擎);
- OTA 机制不变;配置/索引/媒体库数据保留。
LibreTV-fnOS v1.0.7(OTA 自动更新)
LibreTV-fnOS v1.0.7(OTA 自动更新)
应用内 OTA:自动检测 GitHub Releases,顶部「更新 vX」一键完成下载 → 校验 → 替换 → 自动重启,
配置 / STRM 索引 / 媒体库均保留;重启失败自动回滚。
安装包
| 文件 | 用途 | SHA256 |
|---|---|---|
libretv-1.0.7.fpk |
全新安装 / 手动升级 | cb0e64a59a06b1f40fb71177cbb2baddef1df69a5309989be8b00f59a44e28c1 |
libretv-update-1.0.7.tar.gz |
应用内 OTA 载荷 | db3c650829f54ee3f919f8cf4d1e1c4e244c83593324a77bb85790d27d253518 |
1.0.3 及更早版本无更新器,需手动安装一次 1.0.7;之后即可使用页面内一键更新。
1.0.4–1.0.6 存在重启路径问题,建议直接安装 1.0.7。
OTA 说明
- 检查频率:启动后 15 秒 + 每 6 小时;可在
config.update调整; - 下载走 GitHub API 资产(objects.githubusercontent.com),sha256 digest 校验;
- 只替换
server/运行载荷,保留server.old-<旧版>备份;健康检查失败自动回滚; - OTA 后应用内版本为新版,飞牛应用中心仍显示所安装 FPK 的版本号(再次安装 FPK 会覆盖,数据保留)。
LibreTV-fnOS v1.0.3(MCP)
LibreTV-fnOS v1.0.3
新增 MCP(Model Context Protocol)服务:DeepSeek Harness、WorkBuddy 等 AI 客户端可以直接
搜索资源、加入飞牛影视库、删除 STRM、触发同步与媒体库扫描。
安装包
libretv-1.0.3.fpk(约 52 MB)- SHA256:
f1183dc96206d59350d5c877ce1a86d457718acce27817e910c347ea5b123dd6
MCP 功能
- 服务随应用启动(独立端口 8092,与 Web/STRM 引擎同进程),并提供
http://<NAS>:8090/api/mcp同源入口 - Token 自动生成,在 LibreTV → 设置 → 媒体库 → STRM 媒体库 →「MCP 服务」查看/复制/重置/启停
- 鉴权:
Authorization: Bearer <MCP_TOKEN> - 工具(11 个):
search_videos、get_video_detailadd_to_library(生成 STRM + 索引 + 影视扫描)list_library、get_strm_contentremove_from_library(删 STRM + 清空目录 + 移索引,仅限 STRM 根目录内且索引引用的文件)sync_library、cleanup_orphansget_engine_status、refresh_media_library、list_sources
- 资源:
libretv://library、libretv://status、libretv://sources - 仅支持 stdio 的客户端:使用
mcp/stdio-bridge.js桥接 - 文档:https://github.com/HarmonyRun/LibreTV-fnOS/blob/main/docs/MCP.md
升级说明
- 升级/重装保留
var/(配置、索引、日志),已有 STRM 不受影响; - 首次启动自动生成
config.mcp.token并监听 8092; - 旧的局域网/公网播放(8090 LibreTV + 8091 影视库代理)与 FN Connect 原生直连方式不变;
- 如不需要 MCP,可在设置页禁用(无需重启,立即生效)。
已知限制
- FN Connect / 中继只转发 fnOS 主网关,8090/8091/8092 在中继下不可达;MCP 请在局域网或公网直连环境使用;
- 播放侧限制与 1.0.2 相同:中继/远程观看请使用飞牛影视原生页面/App;局域网/公网可用 8091 兼容代理;
- 个别采集源 CDN 对代理出口返回 403/404,Clash 用户请参考 docs/CLASH-RULES.md 设置 DIRECT。
LibreTV-fnOS v1.0.2
LibreTV-fnOS v1.0.2
飞牛 OS(fnOS)原生 FPK 应用,把 LibreTV 与内置
STRM 自动化引擎、影视兼容播放代理打包成一个可直接安装的应用。
安装包
libretv-1.0.2.fpk(约 51 MB,内置 Node.js 22 linux-x64 运行时 + Next.js standalone + STRM 引擎 + 影视兼容代理)- SHA256:
69ba58027af8690120e05e34454d6cfc8d800592ebb9d8ffeb451838a61e8d47
功能
- LibreTV 搜索/播放 Web 前端(Next.js)
- 详情页「加入媒体库」→ 自动生成
.strm(电影片名 (年份)/片名 (年份).strm;剧集Season 01/片名 - SxxExx.strm) - 持久化索引 + 6 小时增量同步 + 孤儿文件清理
- 飞牛影视 API 定向扫描(登录后自动匹配媒体库;不支持时降级为日志提示 + 手动扫描)
- 影视兼容代理(8091):应用内反向代理飞牛影视 Web,把 HLS 直链改写为 NAS 本地中转,
解决飞牛影视 0.9.8 不支持 HLS STRM 直连、以及客户端代理/源站防盗链导致的播放失败
环境要求
- 飞牛 fnOS ≥ 1.1.8(实测 1.2.0800)
- 飞牛影视 trim.media(实测 0.9.8-1)
- 安装到
/vol2(或任意存在/vol2/1000用户目录的存储卷)
安装步骤
- 下载
libretv-1.0.2.fpk→ 应用中心 → 手动安装,选择存储空间/vol2; - 向导填写 STRM 根目录(先在文件管理创建普通文件夹,例如
/vol2/1000/strmdata)与访问密码; - 安装后到 应用中心 → LibreTV 影视库 → 应用设置 → 授权目录,把 STRM 目录加为「读写」;
- 打开
http://<NAS-IP>:8090登录 LibreTV,搜索 → 详情页点「加入媒体库」; - 飞牛影视中添加媒体库指向该 STRM 目录(自动扫描);
- 播放:打开 LibreTV 顶部「影视库」(
http://<NAS-IP>:8091/),首次用飞牛影视账号登录,
之后播放走应用内 NAS 中转,不需要修改客户端代理。
同版本重复安装会被飞牛应用中心跳过;升级请在 Web UI 卸载后重装,或提升版本号走升级流程。
已知限制
- 飞牛影视 0.9.8 原生不支持 HLS 的
.strm直连(DirectLinkPullError),请使用 8091 兼容入口播放;
播放流量经过 NAS,不属于 302 零流量模式; - 飞牛影视 TV App 目前无法自定义服务器地址,兼容入口适用于手机/平板/电脑浏览器;
- CMS 直链有时效性与防盗链,失效时重新点一次「加入媒体库」刷新;预置片源健康度无保证;
- 本应用为第三方封装,仅用于技术学习与研究,片源与内容均来自第三方网络。
许可证
AGPL-3.0-or-later,与上游 LibreTV 一致。
远程访问说明(FN Connect / 中继)
- 局域网 / 公网直连:使用 LibreTV 8090 + 顶部「影视库」8091(NAS 中转兼容播放);
- FN Connect / 二级域名 / 飞牛中继:中继只转发 fnOS 主网关端口,8090/8091 不可达,
请观看者直接使用 飞牛影视原生页面/App(客户端直连源站,视频不经过 NAS/中继); - 已实测:中继环境下原生播放《沙丘》《庆余年》成功。
- 详细说明:https://github.com/HarmonyRun/LibreTV-fnOS/blob/main/docs/REMOTE-ACCESS.md