Repository navigation
Releases: songloft-org/songloft-player-lynx
Release list
Dev build
Songloft Player (Lynx) dev
Commit / 提交: e41987c5b6f3f4a0315e0e54914207c45868a458
安装说明（中文）
本客户端需要连接已运行的 Songloft 服务器。安装后填写服务器地址并登录；客户端不包含本地后端。
在本页 Assets 中选择对应平台的文件：
| 平台 | 下载文件 | 安装 / 部署方式 |
|---|---|---|
| Android | songloft-lynx-android.apk |
下载并打开 APK，按系统提示允许安装。安装包使用维护者的发布签名。 |
| iOS | songloft-lynx-ios-nosign.ipa |
未签名的设备包，需使用自己的开发者证书和适用于目标设备的 provisioning profile 重签，再按签名工具的流程安装。 |
| HarmonyOS | songloft-lynx-harmony.hap |
已签名 HAP，使用 DevEco Studio 或 hdc install songloft-lynx-harmony.hap 安装；目标设备须在签名 profile 的授权范围内。 |
| Web（独立部署） | songloft-lynx-web-standalone.tar.gz |
解压并部署到静态服务器，打开站点后填写 Songloft API 地址。 |
| Web（同源部署） | songloft-lynx-web-embedded.tar.gz |
解压并配置同源静态资源服务，使用同源后端；此包不会自动替换服务器现有的内嵌前端。 |
Web 部署需 HTTPS（localhost 除外），并设置 Cross-Origin-Opener-Policy: same-origin 和 Cross-Origin-Embedder-Policy: require-corp 响应头；具体配置见 Web 部署指南。
下载校验： 将安装包与 checksums.txt 放在同一目录，Linux 可运行 sha256sum -c checksums.txt --ignore-missing；macOS 使用 shasum -a 256 <文件名>，Windows 使用 PowerShell Get-FileHash <文件名> -Algorithm SHA256，对照清单中的 SHA-256。version.json 提供版本、提交、构建时间和包信息。
更多平台要求与连接步骤见 安装指南。
Installation (English)
This client connects to a running Songloft server. Enter the server address and sign in after installation. The client does not include a local backend.
Choose the file for your platform under Assets on this page:
| Platform | Download | Installation / deployment |
|---|---|---|
| Android | songloft-lynx-android.apk |
Download and open the APK, then allow installation when prompted. The package uses the maintainer's release signature. |
| iOS | songloft-lynx-ios-nosign.ipa |
Unsigned device build. Re-sign with your developer certificate and a provisioning profile for your device, then follow your signing tool's installation process. |
| HarmonyOS | songloft-lynx-harmony.hap |
Signed HAP. Install with DevEco Studio or hdc install songloft-lynx-harmony.hap. The signing profile must authorize your device. |
| Web (standalone) | songloft-lynx-web-standalone.tar.gz |
Extract and deploy to a static server, then open the site and enter the Songloft API address. |
| Web (embedded) | songloft-lynx-web-embedded.tar.gz |
Extract and configure same-origin static hosting with the same-origin backend. This package does not automatically replace the server's existing embedded frontend. |
Web hosting requires HTTPS (except localhost) and the response headers Cross-Origin-Opener-Policy: same-origin and Cross-Origin-Embedder-Policy: require-corp. See the Web deployment guide for configuration.
Verify downloads: Keep your packages and checksums.txt in the same directory. On Linux, run sha256sum -c checksums.txt --ignore-missing. On macOS, use shasum -a 256 <filename>; on Windows, use PowerShell Get-FileHash <filename> -Algorithm SHA256. Compare the result with the listed SHA-256. version.json contains the version, commit, build time, and package information.
See the installation guide for platform requirements and connection steps.
更新记录 / Changelog
✨ New Features
🐛 Bug Fixes
e924f05- release: 修复版本确认提示与取消状态 (commit by @hanxi)1ad0eaf- player: 优化大播放队列渲染与状态保存 (commit by @hanxi)9ced2b8- settings: 说明辅助功能会停用封面背景（Ref songloft-org/songloft#523） (commit by @hanxi)2e37e89- web: 归档校验区分文档 base 与静态资源 (commit by @hanxi)209f6c8- web: 保留独立嵌入静态包的子目录部署 (commit by @hanxi)e69cef9- web: 修复安卓浏览器输入键盘与底栏定位 (commit by @hanxi)364607b- web: 输入时收起悬浮导航和播放器 (commit by @hanxi)e41987c- player: 加深歌词封面背景 (commit by @hanxi)
Contributors
Assets 11
v0.1.2
Songloft Player (Lynx) v0.1.2
Commit / 提交: 2698e2eb1d85990f8c1433261e430697aaf3b33d
安装说明（中文）
本客户端需要连接已运行的 Songloft 服务器。安装后填写服务器地址并登录；客户端不包含本地后端。
在本页 Assets 中选择对应平台的文件：
| 平台 | 下载文件 | 安装 / 部署方式 |
|---|---|---|
| Android | songloft-lynx-android.apk |
下载并打开 APK，按系统提示允许安装。安装包使用维护者的发布签名。 |
| iOS | songloft-lynx-ios-nosign.ipa |
未签名的设备包，需使用自己的开发者证书和适用于目标设备的 provisioning profile 重签，再按签名工具的流程安装。 |
| HarmonyOS | songloft-lynx-harmony.hap |
已签名 HAP，使用 DevEco Studio 或 hdc install songloft-lynx-harmony.hap 安装；目标设备须在签名 profile 的授权范围内。 |
| Web（独立部署） | songloft-lynx-web-standalone.tar.gz |
解压并部署到静态服务器，打开站点后填写 Songloft API 地址。 |
| Web（同源部署） | songloft-lynx-web-embedded.tar.gz |
解压并配置同源静态资源服务，使用同源后端；此包不会自动替换服务器现有的内嵌前端。 |
Web 部署需 HTTPS（localhost 除外），并设置 Cross-Origin-Opener-Policy: same-origin 和 Cross-Origin-Embedder-Policy: require-corp 响应头；具体配置见 Web 部署指南。
下载校验： 将安装包与 checksums.txt 放在同一目录，Linux 可运行 sha256sum -c checksums.txt --ignore-missing；macOS 使用 shasum -a 256 <文件名>，Windows 使用 PowerShell Get-FileHash <文件名> -Algorithm SHA256，对照清单中的 SHA-256。version.json 提供版本、提交、构建时间和包信息。
更多平台要求与连接步骤见 安装指南。
Installation (English)
This client connects to a running Songloft server. Enter the server address and sign in after installation. The client does not include a local backend.
Choose the file for your platform under Assets on this page:
| Platform | Download | Installation / deployment |
|---|---|---|
| Android | songloft-lynx-android.apk |
Download and open the APK, then allow installation when prompted. The package uses the maintainer's release signature. |
| iOS | songloft-lynx-ios-nosign.ipa |
Unsigned device build. Re-sign with your developer certificate and a provisioning profile for your device, then follow your signing tool's installation process. |
| HarmonyOS | songloft-lynx-harmony.hap |
Signed HAP. Install with DevEco Studio or hdc install songloft-lynx-harmony.hap. The signing profile must authorize your device. |
| Web (standalone) | songloft-lynx-web-standalone.tar.gz |
Extract and deploy to a static server, then open the site and enter the Songloft API address. |
| Web (embedded) | songloft-lynx-web-embedded.tar.gz |
Extract and configure same-origin static hosting with the same-origin backend. This package does not automatically replace the server's existing embedded frontend. |
Web hosting requires HTTPS (except localhost) and the response headers Cross-Origin-Opener-Policy: same-origin and Cross-Origin-Embedder-Policy: require-corp. See the Web deployment guide for configuration.
Verify downloads: Keep your packages and checksums.txt in the same directory. On Linux, run sha256sum -c checksums.txt --ignore-missing. On macOS, use shasum -a 256 <filename>; on Windows, use PowerShell Get-FileHash <filename> -Algorithm SHA256. Compare the result with the listed SHA-256. version.json contains the version, commit, build time, and package information.
See the installation guide for platform requirements and connection steps.
更新记录 / Changelog
✨ New Features
e48b491- jsplugin: 支持 GitHub Token 与商店客户端渐进加载 (commit by @hanxi)d2124fe- player: 支持全屏歌曲信息选择复制 (commit by @hanxi)a69a45f- playlists: 优化歌单浏览并支持隐藏首页电台 (commit by @hanxi)9a92929- lyrics: 支持歌词页屏幕常亮配置 (commit by @hanxi)
🐛 Bug Fixes
4641dc7- jsplugin: 优先处理插件内部返回操作 (commit by @hanxi)5b74fb0- ci: 为 HarmonyOS 依赖安装增加有限重试 (commit by @hanxi)1f4715d- settings: 渲染客户端更新说明的 Markdown (commit by @hanxi)e9ac244- player: 修正 iOS 后台切歌执行窗口与音源准备竞态 (commit by @hanxi)c278a72- settings: 修复 Android 与后端更新说明的 Markdown 渲染 (commit by @hanxi)be86b3c- settings: 修复后端更新通道请求参数 (PR #11 by @hanxi)992eb49- jsplugin: 支持插件每日发布序号比较 (commit by @hanxi)d1c7ae7- android: 完善退出及缓存和进度滑块（Ref songloft-org/songloft#520） (commit by @hanxi)
📝 Documentation Changes
728c504- changelog: 更新 v0.1.1 变更记录 (commit by @github-actions[bot])8c58029- updater: 补充更新说明 Markdown 跨平台验证记录 (commit by @hanxi)0651222- ai: 统一连续开发与跨仓库复盘流程 (commit by @hanxi)
🔧 Chores
Contributors
Assets 11
v0.1.1
Songloft Player (Lynx) v0.1.1
Commit / 提交: c6afad139b64cf2071c60e2bd189dbf8bfeb88a1
安装说明（中文）
本客户端需要连接已运行的 Songloft 服务器。安装后填写服务器地址并登录；客户端不包含本地后端。
在本页 Assets 中选择对应平台的文件：
| 平台 | 下载文件 | 安装 / 部署方式 |
|---|---|---|
| Android | songloft-lynx-android.apk |
下载并打开 APK，按系统提示允许安装。安装包使用维护者的发布签名。 |
| iOS | songloft-lynx-ios-nosign.ipa |
未签名的设备包，需使用自己的开发者证书和适用于目标设备的 provisioning profile 重签，再按签名工具的流程安装。 |
| HarmonyOS | songloft-lynx-harmony.hap |
已签名 HAP，使用 DevEco Studio 或 hdc install songloft-lynx-harmony.hap 安装；目标设备须在签名 profile 的授权范围内。 |
| Web（独立部署） | songloft-lynx-web-standalone.tar.gz |
解压并部署到静态服务器，打开站点后填写 Songloft API 地址。 |
| Web（同源部署） | songloft-lynx-web-embedded.tar.gz |
解压并配置同源静态资源服务，使用同源后端；此包不会自动替换服务器现有的内嵌前端。 |
Web 部署需 HTTPS（localhost 除外），并设置 Cross-Origin-Opener-Policy: same-origin 和 Cross-Origin-Embedder-Policy: require-corp 响应头；具体配置见 Web 部署指南。
下载校验： 将安装包与 checksums.txt 放在同一目录，Linux 可运行 sha256sum -c checksums.txt --ignore-missing；macOS 使用 shasum -a 256 <文件名>，Windows 使用 PowerShell Get-FileHash <文件名> -Algorithm SHA256，对照清单中的 SHA-256。version.json 提供版本、提交、构建时间和包信息。
更多平台要求与连接步骤见 安装指南。
Installation (English)
This client connects to a running Songloft server. Enter the server address and sign in after installation. The client does not include a local backend.
Choose the file for your platform under Assets on this page:
| Platform | Download | Installation / deployment |
|---|---|---|
| Android | songloft-lynx-android.apk |
Download and open the APK, then allow installation when prompted. The package uses the maintainer's release signature. |
| iOS | songloft-lynx-ios-nosign.ipa |
Unsigned device build. Re-sign with your developer certificate and a provisioning profile for your device, then follow your signing tool's installation process. |
| HarmonyOS | songloft-lynx-harmony.hap |
Signed HAP. Install with DevEco Studio or hdc install songloft-lynx-harmony.hap. The signing profile must authorize your device. |
| Web (standalone) | songloft-lynx-web-standalone.tar.gz |
Extract and deploy to a static server, then open the site and enter the Songloft API address. |
| Web (embedded) | songloft-lynx-web-embedded.tar.gz |
Extract and configure same-origin static hosting with the same-origin backend. This package does not automatically replace the server's existing embedded frontend. |
Web hosting requires HTTPS (except localhost) and the response headers Cross-Origin-Opener-Policy: same-origin and Cross-Origin-Embedder-Policy: require-corp. See the Web deployment guide for configuration.
Verify downloads: Keep your packages and checksums.txt in the same directory. On Linux, run sha256sum -c checksums.txt --ignore-missing. On macOS, use shasum -a 256 <filename>; on Windows, use PowerShell Get-FileHash <filename> -Algorithm SHA256. Compare the result with the listed SHA-256. version.json contains the version, commit, build time, and package information.
See the installation guide for platform requirements and connection steps.
更新记录 / Changelog
✨ New Features
a486924- core: 批2 核心基础设施（models+zod / 网络401单飞刷新 / UrlHelper / 存储 / Query无DOM / Zustand） (commit by @hanxi)6aa99d5- auth: 批3 登录页 + 鉴权守卫 + token 持久化 (commit by @hanxi)d709d32- library: 批4 歌曲列表 + 分页（useInfiniteQuery + QueryClientProvider 首次入包） (commit by @hanxi)640aab9- player: 批5 播放页 + mini-player + TS mock 音频 (commit by @hanxi)b8a3cf0- playlist: 批6 歌单列表 + 详情 + Library Playlists 视图 (commit by @hanxi)74460e1- library: Categories 分类卡片钻取到分类歌曲列表 (commit by @hanxi)313fb06- home: 批7 首页（问候 + 我的歌单/电台区块 + 统计条） (commit by @hanxi)6599c7c- settings: 批8 设置页（自包含项） (commit by @hanxi)686cf8a- i18n: 批9 国际化（i18next 无 DOM 接入 + en/zh + 语言切换 + arb 转换脚本） (commit by @hanxi)05fc7fe- android: B1 Android 原生宿主 + 内嵌 bundle + CI dev APK (commit by @hanxi)d7efd4b- android: B2 真原生音频 SongloftAudio（ExoPlayer/media3） (commit by @hanxi)dd0ad2e- library: 搜索（防抖 Input + keyword 参数）+ 排序（Recent/Title/Artist）+ i18n 资源扩展 (commit by @hanxi)29a1ee6- playlist: 歌单 CRUD（创建/编辑/删除 + 歌曲移除 + 内置歌单保护） (commit by @hanxi)739eb52- player: 睡眠定时 UI + 逐字/翻译/罗马音歌词解析 (commit by @hanxi)68679f5- library: 收藏切换 + 播放模式启动恢复 + 登出清缓存 (commit by @hanxi)fcbc9b4- home: 移除登出按钮 + 原生下拉刷新 + 正在播放歌单高亮 (commit by @hanxi)b5f0319- playlist: 歌单排序 + 歌单内歌曲排序（上移/下移按钮） (commit by @hanxi)f5903be- player: 歌词本地缓存 + 补充遗留 i18n key/icons (commit by @hanxi)251943a- playlist: 内置歌单封面加心形徽标 (commit by @hanxi)542fee7- player: 播放队列抽屉加上移/下移排序 (commit by @hanxi)3635830- theme: 主题 light/system 三选一切换 (commit by @hanxi)d894661- cover: 封面图 URL 补缓存刷新参数 (commit by @hanxi)0aa66f5- settings: 诊断类·日志级别选择 + 日志导出查看 (commit by @hanxi)13b5970- playlist: 补充端点 · song-ids / touch / visibility / sort (commit by @hanxi)a5dbc81- jsplugin: 插件模块 · 管理层 + 首页网格 + 宿主桥接 (commit by @hanxi)3f98950- jsplugin: 插件注册表商店页面 (commit by @hanxi)a644c41- jsplugin: 插件 WebView 渲染 + 动态 Tab 显示 (commit by @hanxi)a0aec58- jsplugin+home: Tab 配置页 + 首页区块横向滚动 (commit by @hanxi)65ff185- library-ops: 音乐库扫描 · 进度轮询 + 目录树 + 扫描开关 + 元数据刷新 (commit by @hanxi)fd68e56- auth: dev 默认凭据预填 admin/admin + 修正类型检查命令 (commit by @hanxi)d244d4f- theme+i18n: 外观与语言真正跟随系统（宿主注入 + 实时推送） (commit by @hanxi)5054173- android: 通知栏下一曲/收藏按钮 + 正式小图标 (commit by @hanxi)ef5a4d1- 底部导航插件 tab 图标改为插件自己的图标 (commit by @hanxi)142967b- library-ops: 排除目录管理三 Tab（对齐 Flutter ExcludeDirManager） (commit by @hanxi)503109d- theme: 暗色对比度审计（WCAG AA：拆 --primary/--accent/--danger/--danger-2 + contrast 回归测试） *(commit by @han...
