Navidrome Stage for webOS
把 Folia 的沉浸式歌词舞台搬上 LG webOS 电视 — 九种歌词可视化、逐字同步、遥控器全操作、连接自建 Navidrome
- Sideload / dev mode
- Stable
- Low brick risk
This project hasn't been claimed by its maintainer yet, so its details come from the community. Is it yours? Claim it
0.8.4 更新登录流程、低彩度封面取色与歌词分词。
主要改进
- 登录页分为服务器与凭据两步。先通过不携带凭据的
/rest/ping检测地址,确认可达且提供 Subsonic 响应后再输入账号密码;裸 IP/主机名默认补全http://和端口4533,探测超时为 8 秒。 - 低彩度封面继续从真实封面生成配色:按顺序识别小面积彩色元素、整体色偏或中性银灰;只有缺少或无法读取封面时才使用静态回退。
- 老电视缺少
Intl.Segmenter时,英文歌词按词切分,CJK 文字按字符切分;日文短语末尾的单字块会并入前一短语,按字数比例分配的计时不变。 - webOS 平台层、IPK 打包流程和 CDP 调试工具统一使用共享的
webos-tv-kit子模块,并增加明确的载荷清单与体积检查。 - README 预览图已更新为来自 LG webOS 实机的 WebP 截图,中英文说明同步更新。
完整改动见 CHANGELOG.md。
安装
下载下方 IPK。开发者模式电视使用 LG ares-install 安装;已 root 的电视按照 README 中的 opkg 流程安装。首次安装或 appinfo.json 更新后需要重启电视。
已通过 npm run check,并在 LG OLED42C2PCA(webOS 10.3.1)上完成 CDP 热更新与运行验证。
sha256 132cd1957c5b4d7140f8f988c811ccd97008648ca4fdde4fac7fcf56928ce99c
0.8.4 updates server discovery, low-chroma cover palettes, and lyric segmentation.
Highlights
- Sign-in is now a two-step flow. A credential-free
/rest/pingprobe must find a reachable Subsonic response before the credentials step appears; bare hosts and IPs default tohttp://and port4533, and the probe times out after eight seconds. - Low-chroma artwork remains cover-derived: the palette selects a concentrated colour accent, a coherent colour cast, or a neutral silver treatment in order. The static fallback is reserved for missing or unreadable artwork.
- On TVs without
Intl.Segmenter, English lyrics stay grouped by word while CJK text is split character by character. A trailing one-character Japanese phrase joins the preceding phrase without changing proportional karaoke timing. - Platform glue, IPK packaging and CDP debugging now use the shared
webos-tv-kitsubmodule, with an explicit payload list and size gate. - The README gallery now uses WebP screenshots captured from the LG webOS device, and the Chinese and English documentation are kept in sync.
See CHANGELOG.md for the full list.
Install
Download the IPK below. On a TV in developer mode, install it with LG's ares-install; on a rooted TV, follow the opkg path in the README. Reboot after the first install or an appinfo.json update.
Verified with npm run check, a CDP hot update, and runtime checks on an LG OLED42C2PCA running webOS 10.3.1.
sha256 132cd1957c5b4d7140f8f988c811ccd97008648ca4fdde4fac7fcf56928ce99c
Before you start
- How hard is it?
- EasyCopy a file or use a web page. No extra software.
- What you need
- Comfort with the command line
- A computer
- Can it break my device?
- Very unlikely to break anything.
- Can I undo it?
- The project doesn't say. Assume you can't.
Did it work for you?
Did Navidrome Stage for webOS v0.8.4 work on your LG OLED C3?
No reports yet for v0.8.4.
One-tap reports from owners. Bricked reports are checked before they count.
Compatibility
Devices: LG OLED C3.
No compatibility information yet.
Getting started
From the project's README ("安装"):
方式 A — Homebrew Channel(规划中)
上架 webosbrew/apps-repo 后,可在电视的 Homebrew Channel 中搜索安装。
方式 B — 开发者模式 / 手动 sideload
从 Releases 下载已构建的 IPK。
开发者模式: 使用 LG 官方 ares-install 安装 IPK。
已 root 电视(opkg 路径,绕过 appinstalld 解包失败):
将下方 TV 换成电视的局域网 IP,或本机 ~/.ssh/config 中已配置的主机名。
scp com.cheerchen.navidromestageall.ipk root@TV:/tmp/stage.ipk ssh root@TV 'opkg --add-dest developer:/media/developer install -d developer /tmp/stage.ipk &&
mkdir -p /media/developer/apps/usr/palm/applications/ &&
cp -a /media/developer/usr/palm/applications/com.cheerchen.navidromestage
/media/developer/apps/usr/palm/applications/' ssh root@TV 'sync; reboot' # 首次安装或 appinfo.json 更新后需重启,sam 才会重新读取应用元数据也可本地打包(需要先初始化 webos-tv-kit 子模块, CDP 调试脚本也在其中):
git submodule update --init # 首次 clone 后执行一次 ./scripts/package.sh → com.cheerchen.navidromestage<version>all.ipk(约 16 MB)
脚本从干净的暂存目录构建,只放随包分发的文件;直接对仓库根目录跑 ares-package 会把 .git 与截图一并打进去。
Risk and recovery
- Brick risk
- Low
- Requires opening the device
- No
Releases
| Version | Name | Released |
|---|---|---|
| v0.8.4 | —Latest | 3 August 2026 |
| v0.8.3 | — | 31 July 2026 |
| v0.8.1 | — | 29 July 2026 |
| v0.7.0 | — | 28 July 2026 |
Credits, license and support
- License
- AGPL-3.0