Skip to content

Releases

LibreTV-fnOS v1.0.14(默认源修复)

Choose a tag to compare

@HarmonyRun HarmonyRun released this 19 Nov 03:20

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

升级方式

  1. 应用内 OTA(1.0.11+):打开 LibreTV → 顶部「更新 v1.0.14」→ 一键更新(保留配置/索引/STRM);
  2. 应用中心手动安装:下载 libretv-1.0.14.fpk → 应用中心 → 手动安装(升级保留 var/,并触发上面的默认源迁移)。

若暂时无法升级:可手动把 /vol2/@appdata/libretv/config.json 的 sources 改为可用源后重启应用。

LibreTV-fnOS v1.0.13(换源迁移)

Choose a tag to compare

@HarmonyRun HarmonyRun released this 19 Nov 01:38

⚠️ 本版本存在默认源问题:全新安装会写入已被墙的旧默认源(电影天堂/量子/如意/优质),导致新装机器搜索为空。请改用 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,MCP remove_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

升级方式

  1. 应用内 OTA(1.0.11 及以上):打开 LibreTV,顶部出现「更新 v1.0.13」后一键更新(保留配置、索引与 STRM);
  2. 应用中心手动安装:下载 libretv-1.0.13.fpk,应用中心 → 手动安装(升级保留 var/ 数据)。

换源迁移默认开启(同步时自动执行);可在 var/config.json 设 "migrateOnSourceChange": false 关闭自动迁移,手动按钮仍可用。

LibreTV-fnOS v1.0.11(商店送审准备)

Choose a tag to compare

@HarmonyRun HarmonyRun released this 23 Oct 10:49

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
(SHA256 05f3cee5cb40bf4a4bdf68f16bb3f636fc4e5f854a57a5df3dad78941f59e2b9),
与社区版功能一致,仅默认关闭应用内 OTA。

验证

  • 8091 未登录:302 → 8090;登录后 200;
  • 8090 密码登录、8092 MCP Token、8093 仅 127.0.0.1;
  • 自愈看护进程正常;配置/索引/STRM 数据保留。

LibreTV-fnOS v1.0.10(自愈看护)

Choose a tag to compare

@HarmonyRun HarmonyRun released this 21 Oct 06:23

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(自动追更 + 空目录回收)

Choose a tag to compare

@HarmonyRun HarmonyRun released this 20 Oct 00:26

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 按目录删除)

Choose a tag to compare

@HarmonyRun HarmonyRun released this 19 Oct 13:19

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 自动更新)

Choose a tag to compare

@HarmonyRun HarmonyRun released this 19 Oct 11:50

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)

Choose a tag to compare

@HarmonyRun HarmonyRun released this 19 Oct 10:48

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_detail
    • add_to_library(生成 STRM + 索引 + 影视扫描)
    • list_library、get_strm_content
    • remove_from_library(删 STRM + 清空目录 + 移索引,仅限 STRM 根目录内且索引引用的文件)
    • sync_library、cleanup_orphans
    • get_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

Choose a tag to compare

@HarmonyRun HarmonyRun released this 19 Oct 07:31

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 用户目录的存储卷)

安装步骤

  1. 下载 libretv-1.0.2.fpk → 应用中心 → 手动安装,选择存储空间 /vol2;
  2. 向导填写 STRM 根目录(先在文件管理创建普通文件夹,例如 /vol2/1000/strmdata)与访问密码;
  3. 安装后到 应用中心 → LibreTV 影视库 → 应用设置 → 授权目录,把 STRM 目录加为「读写」;
  4. 打开 http://<NAS-IP>:8090 登录 LibreTV,搜索 → 详情页点「加入媒体库」;
  5. 飞牛影视中添加媒体库指向该 STRM 目录(自动扫描);
  6. 播放:打开 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