Every update, in one place.

本版本包含 68 项改动。

Added

• 支持导出 Mac 应用图标并引导访达设置
• 新增 AMLL TTML DB 歌词源，能取到社区人工打轴的逐字歌词，常带翻译与对唱分声部
• 播放页背景新增「声音律动」：封面取色的底色上一层跟着声音起伏的频谱、波形或星尘 (#312)

Changed

• 补全 1.11.4 更新日志
• 播放时在日志里记下每首歌用到的 ReplayGain：取自曲库还是文件、增益与峰值、最终音量倍数 (#310)
• Mac 播放队列面板空状态改版，打开时定位到正在播放
• 首页加载骨架按用户自己的版面画
• 歌词自带的译文可以单独隐藏 (#311)
• 「沉浸文字动效」改名为「歌词换句过渡」，原生全屏下写明不起作用 (#311)
• iPhone 与 iPad 可以和其他 App 同时播放 (#311)
• 原生全屏可以切到大封面 (#311)
• 有声书排在音乐后面读标签
• 目录标成有声书后子目录跟着显示，子目录也能单独改回音乐
• 迷你条展开到播放页、收起回迷你条都带弹性动画
• 搜索里的 Apple Music 歌曲可以下一首播放、加入队列、喜欢和添加到歌单
• 同一账号的 iPhone、iPad、Mac 共用读好的歌曲标签
• 播放页收起时缩进迷你条胶囊、展开时从胶囊长出来，第一次展开封面不再先糊后清
• 诊断模式能抓几十毫秒的短卡：取栈门槛跟着诊断有效期保存，开发脚本诊断运行默认 60 毫秒
• 搜索结果里点命中的有声书章节，从这一章开始播放，不再接着上次的进度 (#283)
• 专辑的更多菜单可以把整张专辑标成有声书、播客或音乐，有声书标成音乐后收听进度保留，标回来接着原来的地方听 (#283)
• 专辑、歌单、艺人、风格和搜索结果多选时右上角有全选、取消全选和退出多选，和歌曲页一样 (#283)
• 收听台、正在播放和继续收听小组件里的有声书书封整张显示，不再裁掉上下，空出的边垫同一张图的模糊底 (#283)
• 有声书的「继续收听」「开始收听」按钮改成「继续」「开始」 (#283)
• 有声书书架多一种「只显示封面」的排法，封面下不写书名、角上不放「⋯」，菜单仍在长按和右键里 (#283)
• 资料库分类图标可以选「简洁」样式：去掉彩色方块，图标统一用主题色 (#283)
• 极简模式下搜索结果多选时页头有全选和退出 (#283)
• 首页接着听、在听的书、有声书和播客更新的封面和专辑、歌单卡一样大，iPad 和手机横屏跟着一起缩放 (#283)
• 播客页的区块可以在右上角「…」的「调整区块」里调整先后和隐藏 (#283)
• 播客页的搜索框提示改成「你的节目」 (#283)
• 播客单集能读出 MP3 文件里写的章节，Apple TV 也显示 feed 里的章节
• 重新扫描文件夹时保留已读出的标签，只有换过的文件才重新读
• 扫描刚提交后补读不再跳过待读的歌，也不会把整批挂起到下次启动
• 有声书详情页开着时读出第一集的标签，页面跟着这本书走，不再变空
• 手改的标签、换的封面和评分评论在 iPhone、iPad、Mac 之间同步
• 扫描认出文件挪动、标签编辑写回出错时也按资料库里最新的那一行处理
• 别的设备的「我喜欢」和歌单先到、歌曲后扫到时，扫完就点亮
• SMB 等共享文件夹一次扫描少了一大批歌时先保留，再完整扫描几次仍不在才移除
• 全屏效果里逐字歌词改成浪尖式：正在唱的字亮起、浮起并带一圈主题色的光，唱完后落回，长音浮得更高
• 滑动列表时补读到的标签和扫描结果先攒着，停稳后再一次写进资料库
• 书籍详情页的语速键和首页电台大卡改跟有声书、电台自己的颜色，有声书播放页底部按钮全藏后不再留细线和空白 (#313)
• AMLL 逐字歌词源改为默认开启，升级后也自动打开
• 电台、有声书、播客的「跟随封面」改成各跟各最近播放的封面，自定义颜色可以用取色器挑 (#313)
• 播放页可以设成始终深色，电台播放页把空白挪到台标两侧，有声书播放页顶部按钮挪走后换成把手 (#313)
• 有声书小组件「继续收听」也能显示文件夹里的封面图、服务器给的封面等还没缓存到本机的书封 (#313)
• 全屏文稿的外观选「跟随系统」后随系统深浅切换，自定义主题可以给浅色、深色外观各调一套颜色 (#313)
• 有声书读出标签换了书的 id 后，倍速、归档、收藏、书架顺序、首页挑的书和保持离线跟着这本书走
• Mac 侧栏和 Apple TV 顶栏左上角的音符换成 App 图标
• Apple TV 播放页浅色外观下唱过的歌词后面不再垫一排灰色方块，进全屏时不再先闪「歌名 - 歌手」再和当前句叠在一起
• 滚动封面多的页面更顺：滑出屏幕的封面不再补跑一段占位淡入，没有专辑封面的专辑卡滚回来时不再把两层封面各重建一遍
• Ting Reader 里给书设的跳过片头、片尾会生效：每章从片头结束处开始，播到片尾直接接下一章 (#304)
• 别的设备把同一本有声书听到后面的章节时，本机停着的播放器和「继续」都跟到那一章接着听 (#304)
• 搜索有声书时每个命中的章节各占一行，不再只列出一本书里最前面命中的那一章；行里标题写章节、下面写书名和这一章还剩多久 (#283)
• Mac 刚启动后从别的页面点进首页时，窗口不再被瞬间撑出屏幕右边
• 全屏效果可以自动轮换：每首歌或每隔 1、2、5、10 分钟换一种，像可视化器那样轮着放 (#312)
• 点播放页的全屏键进入原生全屏时不再闪退
• 扫描和读取标签时，其他页面滑动不再被后台整理资料库打断
• 串烧每首改播整段高潮，长短跟着高潮走，淡入淡出落在高潮前后的过渡处
• 有声书、播客、电台页右上角的按钮改跟各自的颜色，不再跟着封面变 (#313)
• 首页电台、有声书、播客区块的标题前不再放彩色小圆点，和其它区块标题一致 (#313)
• 全屏文稿的整段和整句高亮跟上朗读，不再比实际念到的地方慢半拍到一秒 (#313)
• 有声书「始终保持离线」还没下完时写出在等什么：播放中、等 Wi-Fi、低数据或低电量模式、过热、空间不足 (#313)
• 音乐源「缓存」的进度条和实际下载对得上，缓存中可以点一下停止 (#313)
• 有声书「始终保持离线」在 App 前台播放时也接着下载，播放缓冲时才停一下 (#313)
• 播放页从迷你条展开、收回迷你条更顺：卡片贴着胶囊长出和缩回，展开开头不再顿一下，铺满后不再往下溜一截才停
• 播放页封面可以设成铺满：iPhone 竖屏时封面从屏幕顶端铺满整宽，下沿渐隐进背景
• 准备 1.11.5（106）TestFlight 构建

Fixed

• 修复 tvOS 串烧界面测试缺失的智能服务依赖
• 修复智能推荐页刷新时清单消失后闪退

本版本包含 116 项改动。

Added

• 有声书可以在书的菜单和详情页里整本「始终保持离线」，之后新加的章节也会自动下载 (#283)
• 接入 InfiniCLOUD 云音乐源
• 为 Ting Reader 增加收听进度自动与手动同步

Changed

• 网盘短暂限流时，删除、改名、写歌词和播放请求先等冷却结束再发，不再直接失败 (#287)
• 被限流时统一提示「请求过于频繁」和还要等多久，不再显示「服务器返回 HTTP 200/429」(#291)
• 导入外部歌单遵守平台限流且只重试安全读取，私密或已删除的歌单重新给出明确提示 (#280)
• 网盘请求按账号共享限流冷却、重试有上限，百度 token 被提前吊销时能自动刷新 (#248)
• Apple TV 网盘解析共享限流冷却，切歌不再打断别的请求的 token 刷新 (#266)
• 网盘和 NAS 扫描目录时被限流会停在当前目录，点「继续扫描」接着扫 (#290)
• NAS 和媒体服务器读请求共享限流冷却、重试有上限，内网线路卡住时更快切到外网 (#258)
• Plex 账号登录轮询遵守服务端冷却，验证码过期或 plex.tv 持续不可用时及时提示 (#281)
• 请求过于频繁的提示在需要等一分钟以上时按天、小时、分钟说，不再写成几千秒
• Apple TV 播放网盘歌曲时登录会话中途失效，提示改为重新登录，不再显示 NSURLErrorDomain 错误码
• 播放曲库里没有的 Apple Music 歌曲时也能前往专辑，专辑页按 Apple Music 显示整张并能直接播放
• Apple TV 上搜索点播的 Apple Music 歌曲播完后接着播相似歌手和本人的热门曲
• Apple TV 的专辑页列出 Apple Music 上资料库没收的曲目，选中后按整张专辑从这首开始播放
• 重新打开 App 后，曲库里没有的 Apple Music 歌曲所在的播放队列也能恢复
• 播放页背景选了模糊封面或自选图片时，点迷你条拉起播放页直接就是那张图，不再先闪一下浅色底
• 压缩器和混响开关、切预设、拖参数时不再咔哒，开着混响或压缩器加增益时响的歌不再削波，「教堂」混响改回真正的教堂
• 有声书播放页展开时文字稿和目录键随页面一起出现，进度条和下面几排按钮之间拉开间距 (#283)
• 播放页背景选流动色彩时，拉起播放页直接就是封面的颜色，不再先空白一下 (#283)
• 全屏文字稿的语速在菜单里直接加减一档，左右轻扫可以叫出控件或退出全屏，字幕可以选择每条单独成段 (#283)
• 电台播放页台名和播放键挨着台标排，底排按钮均匀铺开不再挤在中间 (#283)
• 首页电台墙的台标上不再标「电台」，卡片下的格式与码率可以在「我的电台」右上角关掉 (#283)
• 播客节目封面上的新单集角标在点进节目后清掉，别的设备订的节目同步过来不再整份历史都算新集 (#283)
• 有声书详情页的「继续收听」在 iPhone mini 等窄屏上保持一行 (#283)
• 电台、有声书、播客在资料库、小组件和 Apple TV 上的颜色与图标和首页顶部切换一致 (#283)
• 电台、播客、有声书小组件点播放键以外的地方打开 App 里对应那一页，正在播的单集和书显示暂停并能点停 (#283)
• 有声书和播客播放页可以按位置换按钮：播放键一行两端、有声书章节那一行能放更多菜单等按钮，AirPlay 能挪到下面那排，关掉目录后不再照样显示 (#283)
• 播客播放页和 iPad 横屏的有声播放页下面那排功能键不再垫圆角方块，和音乐页一样只有图标 (#283)
• 播放曲库里没有的 Apple Music 歌曲时，展开、收起播放页和收起后滑动列表不再掉帧
• 新扫描进来的一批歌在重新打开 App 后保持原来的先后顺序
• 有声书深色播放页的播放键和进度条默认改成白色 (#283)
• 电台、有声书、播客的颜色可以自己选：默认、跟随主题色、跟随封面或固定颜色 (#283)
• 从歌词页下拉收起播放页时封面不再同时放大回去，逐行歌词不再每半秒整列重算
• Apple TV 的封面按卡片实际大小解码，首页和各列表滑动更顺
• Mac 首页滚动更顺：封面拼贴按显示大小解码，不再挤掉其它封面的缓存，数据卡片不再叠毛玻璃
• 主题色跟随封面时，小组件的进度条和播放键也跟着封面色变 (#283)
• 有声书「继续收听」小组件同时显示几本书时，书封整块往下挪，和上面的标题不再挤在一起 (#283)
• 首页顶部切到电台、有声书再切回来时，各区块直接是原来的内容，不再先空着或转圈再弹出 (#283)
• 有声书播放页只有点当前章节那一行打开目录，章号栏不再响应，封面只在有文字稿时切到文字稿 (#283)
• 文件夹里和文件夹同名的图片也会当作封面，本机的书还认和书名同名的图片 (#283)
• 云盘授权和刷新令牌遇到限流时按服务端给的时间再试，不再反复请求，也不会自动重发签发请求 (#293)
• Apple TV 扫码登录云盘时按服务端要求放慢轮询、遵守冷却，二维码过期后不再继续请求 (#294)
• Apple TV 上 NAS 登录途中会话被作废时不再拿旧凭据去播放，单个请求取消也不打断共用的登录 (#292)
• 云盘授权失败时提示里重新带上服务商给的原因，回调地址或应用 ID 填错能看出来 (#293)
• Apple TV 扫码登录云盘时服务端出错，提示回到「服务端返回错误」的说法 (#294)
• Apple TV 上 NAS 切网络时正在登录的那首歌不再被报成「请重新登录」 (#292)
• Last.fm、ListenBrainz 上报和「正在播放」共用服务端限流冷却，重启和手动重试都不会提前再发 (#297)
• ListenBrainz、Last.fm 账号验证分清「无效」和「暂时确认不了」，限流和服务故障不再被报成 token 无效 (#298)
• Apple TV 播放时服务器限流不再被报成字节范围错误，冷却期间换歌、拖动进度不再反复请求同一个源 (#295)
• Apple TV 播放遇到一次不带等待时间的 503 后，自动恢复能照常重新起播 (#295)
• Last.fm、ListenBrainz 上报遇到超长的服务端等待或系统时钟往回拨时，最多停一天 (#297)
• Last.fm 上报回「操作失败，请重试」时留在补报队列里稍后再报，不再直接丢掉 (#297)
• 相似歌曲推荐在 Last.fm 用 HTTP 400 报额度用完时也按限流处理，单曲和按艺人回退共用冷却 (#296)
• ListenBrainz token 验证碰上限流或服务出错时，设置页显示「暂时无法验证」，不再什么都不显示 (#298)
• Apple TV 预取下一首时也遵守这个源的播放冷却，冷却中不再去抢先请求 (#295)
• Apple TV 歌词可以交给智能翻译，播放页加了歌词翻译键；三端说清楚智能翻译没用上的原因
• Apple TV 全屏封面流放同一张专辑时，两侧换成曲库里别的专辑封面，切歌时整排照样滑动
• Apple TV 重新扫描能清掉网盘上已删除的歌，专辑和歌曲长按可以从本机移除
• Mac 播放页「更多」里可以直接选歌词翻译：关闭、系统翻译或智能翻译
• 相似歌曲推荐的 Last.fm 额度限流补上各种 HTTP 状态下的回归测试 (#302)
• 听歌识词的 Gemini 转写每一步都共用 AI 额度，按服务端给的时间等，冷却中不再继续请求 (#299)
• Apple Music 歌单续页读失败时不再被当成完整歌单，取消导入也不再报成网络错误 (#300)
• YouTube 歌单续页被限流时保留已读的曲目，预览里说明还要等多久，到时可以重新读取 (#301)
• 听歌识词转写到删除临时音频时被取消，音频也会补删一次，不再留在 Gemini 上 (#299)
• Apple Music 歌单读到后面某一页出错时，保留已读到的曲目并提示没读完，不再整单导入失败 (#300)
• YouTube 歌单读到 1 万首导入上限时不再提示「没读完」和重新读取 (#301)
• 有声书书架的搜索框提示改成「你的书库」 (#283)
• 目录封面的大文件夹名单里的汉字改成转义写法，本地化检查重新通过
• 全屏字幕控件收起时状态栏一起藏起来，点屏幕左右两边只叫出控件不跳播，左右扫只在控件出来时退出全屏 (#283)
• 播放页背景可以在有声书上用：打开「有声书也使用」后，深色外观的有声书播放页也铺选好的背景 (#283)
• 云盘写回标签、歌词、封面时也遵守这个账号的限流冷却，批量改标签不再在冷却中一直往上传 (#232)
• 开始听在 iPad、横屏、iPhone Duo 和 Mac 上把首卡排成左边两列两行的方块，不再拉成一整条横栏
• 手机横屏和 iPhone Duo 外屏横握时首页顶部也是封面轮播，歌名和按钮在左、封面在右
• 内置 AI 同意页默认展开各功能发送的内容，听歌偏好和上传音频直接在页上打开，iOS 26 起底部按钮换成玻璃胶囊
• 颜色和图标里音乐和电台、有声书、播客一样列成一行，点进去再选主题色
• 本地节目的单集排序里再点一次「按文件顺序」就换成按文件倒序，再点回正序
• 下载离线翻译包前先确认大小，缺包和下载进度在歌词页一直显示到解决，Apple TV 的歌词翻译键在要处理时有提示点
• iCloud 同步设置的同步内容和说明里写明「我喜欢」随歌单一起同步
• 首页「最近添加」「快捷访问」的全部页里点专辑、艺术家、歌单能直接进入，返回一次就回到列表
• Apple TV 播放页按返回收起底部货架后，焦点回到打开货架前所在的那颗键
• 重新读取标签、卡拉OK 分离和写回标签时从音乐源整首下载的文件用完即删，不再一直占用手机空间
• 存储管理列出音乐源文件缓存、音乐视频缓存和旧账号的缓存，可以分别清除
• 移除浏览区域的 section header
• 听歌记录从 iCloud 合并时不再卡住界面
• Apple TV 神经共鸣全屏效果更流畅
• Apple TV 上 Apple Music 起播失败时日志记下完整的错误说明
• 在音乐源页停用或恢复音乐源时界面不再卡住
• Apple TV 播放整个 Apple Music 资料库或长列表时开始得更快
• Apple TV 上 Apple Music 资料库里的歌起播失败时，改用目录里的同一首再试一次
• Apple TV 上沙画、萤火、星尘、极光、封面流、环形声谱等全屏效果更流畅
• 移除已停止维护的 FilesProvider 依赖
• 重新扫描时复用没改过的 CUE，WebDAV 列目录少做重复解析
• FTP 音乐源也会预读：播放时多读一段，下一首提前取开头
• Apple TV 环形声谱全屏效果更流畅
• 全屏效果测量用的分层开关：启动时可去掉环形声谱的某一层
• 关于页的开源许可列表去掉已移除的 FileProvider
• NFS 音乐源改用随 App 编译的 libnfs 8.0，不再依赖 NFSKit
• 专辑详情页在歌名前显示曲目编号
• iPad 竖屏播放页的封面按屏幕高度放大，歌名和进度条之间不再空出一大块 (#303)
• 本机或局域网自建的 Ollama 等模型服务默认关掉思考，并放宽等待时间 (#306)
• 歌词翻译可以设置不翻译的语言，这些语言的歌词保持原文 (#308)
• Mac 智能功能页的「功能 / 服务」切换移到页标题下方，改成通栏分栏并跟随主题色
• Mac 侧栏只留首页、资料库、歌单和音乐源，收藏、智能推荐、听歌统计和工具移到标题栏右侧
• Mac 侧栏换页更快并带入场动画
• Mac 智能推荐改成右侧面板，选择播放设备弹框改版，换页和弹框时红绿灯不再闪
• M4A 文件里的 ReplayGain 开始生效，Navidrome 等 Subsonic 服务器源直接采用服务端给的音量增益 refs #310 已在资料库里的 Subsonic 系音乐源升级后会自动重新同步一次目录，补上已有歌曲的增益。
• 音频解码与标签读写组件 SFBAudioEngine 升级到 0.14.0
• 更新 TestFlight 版本为 1.11.4（104）

Fixed

• 修复 macOS 切换页面时标题栏与窗口按钮闪烁

Performance

• 有声书多时，Mac 首页、Apple TV「有声」页和搜索不再因整理书架而卡顿
• Apple TV 按暂停不再卡住，首页封面、搜索建议和歌单页的卡顿减轻
• 歌单列表、Mac 侧栏、搜索结果和重复歌曲页的卡顿减轻
• 封面载入时不再整页卡顿，服务端歌单与评分同步不再长时间占用主线程
• 停用或恢复音乐源、搜索、流派和缓存同步页的卡顿减轻

本版本包含 31 项改动。

Changed

• 全屏效果可以选择画面帧率，跟随屏幕刷新率时频谱也逐帧刷新 (#179)
• 有声书播放页可以加进「我喜欢」，书架上的书可以整本加进歌单 (#155)
• iPhone 上的动画可以跑到 ProMotion 屏的 120 帧，全屏效果「跟随屏幕」档在 iPhone 上也随屏幕刷新率 (#179)
• 歌单页可以在歌单里查找歌曲 (#180)
• 半小时以上的 m4a/m4b 有声书单集也能读出标签 (#178)
• 资料库的歌曲、歌单、收藏、有声书、播客和发行日期页可以在本页里查找
• 同一本有声书放在不同文件夹的两个版本分成两本，服务器音乐源里同名不同作者的书也不再合并 (#178)
• 只在车机上启动或被 Siri、小组件唤起时也会恢复上次播放的歌 (#181)
• 播放过的专辑、歌单和电台可以出现在系统的「接着听」推荐里 (#181)
• 其他设备同步后，标成有声书的歌不再全部变回音乐 (#155)
• 专辑页和艺人页可以批量补全缺少的简介
• 首页和资料库的布局设置会通过 iCloud 同步到其他设备 (#155)
• 批量补全简介的多语言文案改得更通顺准确
• 泰语里专辑与艺人简介改用「คำอธิบาย」，不再和「推荐」用同一个词
• 正在播放的歌被标成有声书后立即开始记住收听位置
• 打过分的歌很多时，打开 App、切回前台不再长时间卡住 (#182)
• Mac 歌曲右键菜单可以标记为有声书，选中多首歌可以一次移到有声书
• Navidrome 等服务器音乐源里的有声书章节按标题里的序号排列 (#155)
• 专辑页上半屏铺上由封面放大虚化而来的画面，不再只是一块平涂底色
• 歌词页拖动即全屏、对唱分左右、可直接进卡拉OK，唱过的字不再缩回 (#183)
• 首页大封面每次打开都换一组，「随机播放」改为整库随机、不再从居中的封面开始 (#185)
• 首页记住上次选的音乐、电台、有声书或播客，重新打开 App 仍停在那里 (#155)
• 听完的有声书再听一遍仍算已听完，同时记住重听到的位置，下次接着听 (#155)
• 有声书可以归档：书架里单独一栏，不再出现在首页、接着听、小组件、CarPlay 和 Siri 继续听书里 (#155)
• 资料库里自己下载的播客可以标记为播客，按节目归到播客页，播放时和有声书一样记位置、可调速 (#155)
• 重新扫描时，没改过的 CUE 文件和整轨 WAV 的格式判定不再重新下载，带 CUE 的曲库重扫更快、更省流量
• WebDAV 大文件夹列目录更省电
• FTP 音乐源播放时会多读一段、提前取下一首的开头，播放更不容易卡，切到下一首更快
• 移除已停止维护的 FilesProvider 组件，FTP 与 WebDAV 都使用内置客户端
• NFS 音乐源改用随 App 编译的 libnfs 8.0，不再依赖已停止维护的 NFSKit；服务器连不上时按超时及时放弃，不再等系统一分多钟的建连超时
• 准备 1.11.3（97）TestFlight 构建

本版本包含 52 项改动。

Added

• 隔离 tvOS 不支持的内置听歌识词转换逻辑

Changed

• 同步 1.11.1 工程配置
• 离线缓存可以选择音质，网盘等来源的无损歌曲在本机转成 AAC 保存
• 本地化检查不再把 Mac 首页调试截图钩子里的演示书名当成界面文案
• 智能功能设置分成「功能」和「服务」两栏，每个功能可以单独选用某个服务的某个模型
• Mac 版可以独占外接 DAC 输出，设备位深跟随歌曲
• Apple TV 可以按歌曲请求输出采样率，iPhone 的匹配输出采样率挪进音频输出
• 默认 App 图标换成 Primuse，清新音符保留为可选图标
• 播放页「更多」里可以直接开关均衡器、切换预设
• 高保真直通时点播放页「更多」里的均衡器会说明原因，并可一键切到音效输出
• Mac 菜单栏面板也能直接开关均衡器、切换预设，高保真直通时就地说明原因并可切到音效输出
• 播放页的音质与来源改成进度条下方的标签，轻点可查看完整音频信息
• 播放页最底下在连着耳机、蓝牙或投放设备时显示设备名，开着睡眠定时时显示剩余时间
• 歌单、收藏同步和加歌到服务器歌单时，个别歌曲出错只跳过这一首
• Mac 首页「接着听」并入主卡，有声书、播客、电台各一张，没有可接着听的就不显示
• 首页「开始听」加载时的占位不再把页面撑宽
• 「开始听」卡片换成双色底配放大的符号水印，第一张变成带封面的整行大卡
• 听歌统计改为不带图表的听歌回顾，年度报告随时可看
• 缓存达到上限时先删下载中断的半成品、再删最久没听的歌，离线下载与整源缓存不再被一起清掉
• 歌单、专辑和多选批量缓存时跳过 Apple Music 的歌，不再整批逐首失败重试
• 移除听歌统计改版后已失效的旧单测，iOS 测试目标重新能编译
• 专辑和艺人简介点「更多」就地展开全文，可随时收起回到原来几行
• 收藏不再限制数量，专辑、艺术家、歌单和目录点心形即加入收藏，资料库各页右上角按钮收拢
• 首页「查看全部」专辑、列表版式的专辑与歌单行、为你推荐的「前往专辑」进入详情时也从卡片放大展开
• 离线下载单独存放、不计入缓存上限，存储管理里可查看和逐首移除，歌单可一次移除全部离线下载
• 存储管理里离线缓存音质并入「离线下载」一节
• 无缝播放跨采样率换歌时提前备好下一首，并在上一首歌尾的静音里切换输出采样率
• 用自己的 Google 密钥听歌识词时不再附带歌名词表，避免 Google 以词表不能与逐词时间同用为由拒绝请求
• 听歌识词可以交给内置 AI：歌曲先在本机转成小体积音频再上传，不用自己的 Google 密钥
• 设置里的长段说明收进标题或开关旁的圈问号，点开再看
• 播放页的音乐来源回到最底下一行，单独显示时居中
• 首页听歌排行恢复领奖台和名次榜
• 听歌统计改为一页铺开的年度音乐报告，年度插画恢复
• 内置 AI 本月次数用完时，推荐、简介、新歌推荐和听歌识词都提示「本月已用完、下个月恢复」，不再误报为请求太频繁
• 当前套餐不含听歌识词时，内置 AI 的识别入口收起并在设置里说明原因，自己的 Google 密钥照常可用
• 首页顶部改成大封面轮播，左右滑动挑一首开始随机播放
• 准备 1.11.2（94）TestFlight 版本
• 年度报告的榜单占比改为主题色细条，最常听专辑横滑时不再越出边框
• 年度报告里删除后重建的音乐源按地址、账号或歌曲认回原来的源，认不出的标为已删除
• 首页听歌排行的名次行也改为主题色细条显示占比
• Mac 上打开上千首的歌单或「我喜欢」不再卡死
• 首页顶部封面轮播改为左右无限循环滑动，一圈最多 48 张，去掉问候语和页码圆点
• 主屏幕长按 App 图标可以继续播放、随机播放全部、随机播放我喜欢的和搜索
• 上千条的搜索结果和电台导入清单不再卡住界面
• 艺人页刷新时不再反复筛选整库专辑
• Apple TV 的电台、流派、播客单集和有声书章节长列表改为分页显示
• 智能场景推荐按刷新频率重新生成，用内置 AI 时默认每 6 小时一次
• 准备 1.11.2（95）TestFlight 构建

Fixed

• 修正专辑艺人测试对系统排序语言的假设
• 修复系统 27 上启动收取诊断数据时可能闪退
• 修复飞牛音乐新版服务端上歌单与收藏无法同步
• 修复 iPhone 上用 Plex 账号登录时被跳到 watch.plex.tv、看不到授权页 (#168)

本版本包含 122 项改动。

Added

• 增加中日韩离线歌词素材包和英语中转
• feat: read Navidrome native listening history for server statistics
• Plex 支持用账号登录选服务器，好友分享的服务器也能直接添加 (#168)
• 新增 Audiobookshelf 音乐源，有声书与播客按书归入有声书架
• 首页新增情景推荐专辑，按时段、星期、节日和最近在听的挑一整张
• 资料库先摆藏品，新增按年代浏览专辑的「发行日期」页
• 首页新增「开始听」，按风格、年代或此刻的状态一点就播
• Apple TV 首页顶部新增居家场景，按下就放会客、休闲、夜间聆听、专注或派对
• 新增播客：可从 Apple 播客目录搜索或用 RSS 订阅节目，默认收起，可在资料库与首页设置里打开 (#155)
• 添加苹果托管资源包解析器支持

Changed

• 补全 1.10.2 更新日志
• Apple TV 不再整库转换歌曲与专辑，启动和曲库变化后更快出内容
• 歌单打开「始终保持离线」时保留已缓存的歌曲
• 按专辑排序时同一专辑内按碟号和曲目号排列
• Navidrome 服务器正在扫描曲库时，扫描等它完成后继续，不再报扫描失败
• Navidrome 等服务器源的扫描续传不再被上次启动留下的暂存数据挡住，并清理无法续传的暂存数据
• 「始终保持离线」的歌单在音乐源增改外网地址后不再重新下载
• 服务器上的歌换成更大的新版本后，「始终保持离线」在新版下完前仍保留旧版可播
• 全屏效果底部的细进度条随浮动控件一起显示和隐藏
• 服务器换了文件后，「始终保持离线」在重新扫描完成时立即开始更新
• 手动匹配歌词不再把 CUE 整轨专辑里的歌拆出去
• 封面与歌词界面切换时封面始终完整不透明地缩放，不再被原区域裁切或叠出半透明重影 (#167)
• 文件夹和专辑里的歌默认按曲目顺序排列
• Mac 两步验证弹窗去掉内层卡片，验证码与记住设备直接排在弹窗里
• 飞牛音乐歌单同步时读到一个就先显示一个，不再等全部读完
• Navidrome、Jellyfin、Emby、Plex、群晖 Audio Station 与 Songloft 的歌单同步也改为读到一个就先显示一个
• 音乐源只改访问地址或名称时，目录页不再暂时变空
• 音乐源只换访问线路时，评分和离线缓存不再丢失
• CarPlay 卡墙式封面按车机屏幕宽度排满，宽屏车机不再只占左半边
• CarPlay 设置里的封面布局改按列数描述，不再显示车机上并不存在的行数和屏数
• Mac 上的评分与评论改为和其它弹窗一致的面板
• Mac 侧栏资料库加入「歌单」入口，歌单和歌曲顺序改为直接拖动调整
• 内置智能服务不再因商店地区或测试环境识别被误拦
• 菜单栏弹出面板里可以直接开关菜单栏歌词
• 自动切到下一首更快：先保下一首，WebDAV、群晖、UPnP、媒体服务器和 Apple TV 也会提前取开头
• 歌词页翻译状态提示出现一会儿后自动收成小图标，点一下再展开
• 歌词翻译：副歌重复的句子只翻一次、整首用词一致，原文里的 ' 等转义字符正常显示
• 歌词 AI 翻译更快出现：中途打开从正在唱的那句先翻，翻好一行就存一行，下一首的歌词提前翻好
• Mac 桌面歌词可以上岛：收进屏幕顶部刘海，指针移过去展开播放控制
• 自填 AI 服务商的歌词翻译和推荐也逐行显示，中途失败时已翻好的歌词保留
• 优化统一搜索与智能结果播放
• 优化搜索、桌面歌词与增量扫描
• OneDrive 歌曲播放不再中途卡住，下一首也能提前缓冲
• 切歌秒开时播放键不再闪加载圈
• 导入歌单时可以合并进同名的已有歌单 (#174)
• 冷启动时不再闪一下「准备资料库」
• Apple TV 专辑墙可按歌手、标题、年份排序，并能按首字母快速跳转
• 刮削后的歌曲信息重开 App 不再变回文件里的旧值
• 刮削只写勾选的部分，CUE 分轨的曲目信息不再被覆盖
• 填到一半的音乐源配置，切出去后被系统结束也能接着填
• 内置 AI 默认打开，并引导用户改用自己的 AI 服务
• GBK、Big5、日文编码和 UTF-16 的 LRC 歌词也能正常显示
• 扫描 Navidrome 时读回在其他客户端改过的歌曲评分
• Apple TV 在专辑页点歌播放后，按 Menu 先回到专辑页
• 专辑和歌曲可以一键恢复成音乐文件里的标签
• 搜索框提示改成在已入库的曲库中检索
• Apple TV 播放页按歌手名可以进入艺人的全部作品
• iPhone 设置里可以调歌词字号，Apple TV 歌词有四档字号可选
• 播放信息里显示实际输出的采样率
• 长歌词的 AI 翻译不再后半首换成系统翻译
• Emby、Jellyfin、Plex 扫描不再停在服务器报的总数上
• 本机歌曲起播跳过音频缓存检查
• 资料库里的文件夹可以单独重新扫描
• 专辑和艺人可以单独点喜欢
• 大曲库载入与导入快照时少做重复计算
• Apple TV 上的 Plex 源也能跟上服务器换地址，好友的服务器改资料时会说明没有权限 (#168)
• 几十万首的大曲库点随机播放、浏览文件夹不再卡死闪退，占用内存更少
• 专辑和艺人的喜欢与服务器收藏互通
• 大曲库需要重新检查歌曲时载入快得多
• 智能整理标签可以用内置 AI 批量修正曲名、艺人和专辑里的乱码与不规范写法
• 智能整理标签没开发送授权时可以一键打开，新设备默认允许向智能服务发送内容
• Apple TV 从首页和搜索进播放页，按 Menu 回到原来那张卡片或那条结果
• Apple TV 资料库里的文件夹可以单独重新扫描
• Apple TV 专辑页可以一键恢复成音乐文件里的标签
• Apple TV 主屏顶部能显示最近播放、电台和专辑了 (#151)
• 大曲库扫描时不再一直整库重建，载入时整理专辑更快
• iPhone、iPad 专辑页可以按艺术家、标题、年份或最近添加排序
• 选择目录时可以立即扫描已包含的子目录
• 播放页歌名下可以显示音频规格，轻点查看实际输出的采样率
• 本机文件夹里还在 iCloud 上的歌会先下载再播放 (#170)
• Navidrome 专辑评分与服务器互通，群晖 Audio Station 也能读回评分 (#172)
• 播完后自动接着播放相似歌曲 (#166)
• 标成有声的目录里单首「标为音乐」现在真的生效
• 媒体服务器可以按资料库选「音乐 / 有声 / 不同步」，Navidrome 等来源可整体标为有声内容
• Audiobookshelf 的收听进度与服务器双向同步，章节从服务器读取
• Apple Music 歌单里不在资料库中的歌曲也会完整同步过来
• AI 语义搜索搜到的专辑单独成组，可以整张播放或进入专辑
• 播放页可以换背景：模糊封面、专辑封底或自己挑的图片
• 服务器歌单同步不再因个别不规整的条目整份失败
• 首页「为你推荐」接入智能推荐，智能功能设置页分成开关、功能、高级三段
• Apple TV 播放页也能换背景，扫码直传会带上「我的图片」
• 智能功能设置页只在开着歌词翻译时才查离线素材包，模拟器里打开相关设置不再闪退
• 几十万到百万首的大曲库更省内存，打开后不再长时间占满 CPU 发烫
• 为你推荐可以推荐整张专辑，默认前两张是专辑、其余是单曲
• 场景推荐的截图钩子在读入同步设置后仍然生效
• 卡拉OK的 AI 人声分离失败后会自动重试一次并说明原因
• 卡拉OK舞台底部不再随歌词折行或提示跳动，调音选项收成一行摘要
• 卡拉OK更长的歌词再缩小一档，稍长一点的句子不再末字孤行
• 大曲库发到 Apple TV 或 iCloud 前按需拼回完整曲库，超出上限时说明原因
• Mac 从搜索结果点进专辑、艺人或歌单后，接着在搜索框输入会回到结果页，歌单和文件夹页也能返回
• Google Drive 源提前说明 11 月 20 日起改为选择文件接入，以及调整原因和大曲库的替代做法
• 曲库太大发不到 Apple TV 时只传音乐源，Apple TV 收到后自己扫描建立曲库
• Apple TV 单测跟上卡拉OK人声分离的暂停接口
• Google Drive 接入调整提醒改为后续可能发生的变化
• Apple TV 添加 Google Drive 改为扫码后在 iPhone 或 iPad 上登录
• 播放页的音质与规格移到底部来源那一行，歌名下方不再单独占一行
• 全屏效果去掉封面流光、镜面展台和曲名展墙，原先选了它们的会换成最接近的效果
• 全屏效果把星夜和极光帷幕合成「星夜极光」，星空里会有流星划过
• 更新版本至 1.11.1（92）并补齐电视端工程生成配置

Fixed

• 修正封面取色测试在曲库就绪前取基线导致的误报
• 修复 Mac 收不到 iCloud 变更推送，iPhone 上的改动不再要重开 App 才同步过来
• 修复 Apple TV 播放失败切走时偶发闪退
• 修复 iOS 智能转场后台分析闪退
• 修正云盘标签测试的队列初始化
• 修复来源歌单隐藏恢复与飞牛同步兼容
• 修复 Navidrome 原生登录回退并同步工程
• 修复 AAC 歌曲流式播放到中途解码失败，不认分段请求的 WebDAV 也能正常播放
• 修复封面与歌词切换时的重影和缩放裁切

Performance

• 记录曲库发布各步耗时与 iCloud 同步诊断，便于定位启动卡顿和电视收不到同步
• 扫描音乐源时资料库和首页不再频繁整页刷新卡顿，同步歌单也不再反复整库写盘
• 本地文件夹歌曲冷启动后切歌不再卡顿
• iCloud 全量同步时界面不再一阵阵卡顿

本版本包含 87 项改动。

Added

• 添加内存限制增加 entitlement 配置
• 歌词翻译支持英语与波斯语互译，下载离线翻译模型后在本机完成
• 选择扫描目录时，上级已勾选的子目录显示为「已包含」，新增的目录不再勾不上
• Apple TV 支持刮削：可以匹配歌曲信息、补全整张专辑与自动获取在线歌词，封面不再配错

Changed

• 补全 1.10.1 更新日志
• 补齐 1.10.1 英文更新日志并整理中文段落，1.9.8 补上构建 79–82 的改动
• iPhone Duo 竖栏一侧补齐有声、听歌统计、文件夹与智能推荐页，固定的筛选胶囊停在竖栏前
• iPhone Duo 外屏横握摄像头在右下角时，播放页竖栏按钮贴着遮挡区往上排，不再被挡住或排出屏幕
• iPhone Duo 合上、展开时的整屏归位等铰链停稳后再开始，接在系统开合动画后面
• 展开播放页时直接以封面取色滑入，不再先灰底上来、停稳后才变色
• Google Drive、OneDrive 等网盘按歌曲所在的真实文件夹合并同名专辑，文件夹里多数曲目的艺术家能代表整张专辑时不再按曲目艺术家拆开 (#160)
• 第一首歌刚开始播放时展开播放页，进度时间不再先于整页弹上来
• Mac 菜单栏可以显示正在唱的歌词，在歌词设置里打开
• Apple TV 全部播放时队列同样只装一千首、快播完自动续上，旧的整库队列恢复时转成窗口
• Apple Music 资料库里自己导入的歌曲可以显示内嵌歌词，格式、码率和采样率按文件实际显示
• 歌曲里内嵌的 SYLT 同步歌词按行显示，不再并成一整行；iPhone 上 Apple Music 导入的歌曲也能读到
• Apple Music 导入的歌曲暂时读不到时下次同步再补齐音质信息，WAV、AIFF 也显示码率
• 内嵌 SYLT 双语歌词按原文配译文显示，逐字歌词的词间空格不再丢失
• 之前版本读成一整行的 SYLT 同步歌词，升级后自动重新读取并按行显示
• 同步离线歌词翻译的工程文件引用
• 点歌词空白处改为收起或叫回控件，不再切回封面，滑动时的点按也不再误触
• 点歌词空白处恢复回到封面，按住拖动歌词不再误回封面；拖动歌词时显示定位线，可从该句开始播放
• 优化歌词浏览标尺并将跳转按钮移至右侧
• 歌词拖动标尺改为更精致的细线样式，并可在设置中开关（默认关闭）
• 优化启动分类和歌词翻译功能
• 串烧播放群晖等流式来源时直接从片段起点开播，不再先下载解码前面的整段
• 跨端交付约定不再要求维护卡拉OK记录文档
• 移动文档位置
• 加快大曲库启动时的资料库准备
• Apple TV 按下专辑封面先展开曲目列表，播放后回到海报墙停在原来的位置
• 扫码传到 Apple TV 时可以一并同步刮削、歌词 API 服务和智能功能等设置
• 整轨 CUE 分轨后会自动加载每首歌各自的歌词文件，编辑单曲歌词不再影响其他分轨
• Navidrome 等 Subsonic 服务器上的歌单可以在「添加到歌单」里直接加歌
• iPad 与极简导航的迷你播放条在 iOS 26 上改为 Liquid Glass 玻璃样式
• Mac 播放页的 MV 画面不再溢出封面位置、盖住歌词
• 同步歌词与电视刮削的工程文件引用
• 繁体歌词在简体界面下直接显示简体对照，智能推荐语固定使用界面语言与字形
• Apple TV 电台页的台标网格与筛选栏改为和音乐、有声同一套尺寸
• Apple TV 设置里可以调整顶栏菜单的顺序和显示哪些页
• Mac 侧栏资料库按外观设置里的顺序与开关显示，设置页可拖动排序，电台页标签条下不再留大片空白
• 服务器音乐源自动发现新歌：打开 App、回到前台或下拉刷新时检查更新 (#164)
• 减少曲库扫描重复写盘并补全电视 CUE 末轨时长
• 将 Mac 音量滑块测试移入 macOS 测试目标
• Apple TV 播放页可以直接切换专辑、艺术家与流派
• 加快 Apple TV 扫描远端音乐源并减少发热
• Apple TV 可以直接导入自定义刮削源
• 冷启动时封面不再先闪灰色占位
• Apple TV 长按封面菜单精简为五项，不再超出屏幕和闪烁
• Mac 播放器更多菜单的开关改为行尾打勾，不再顶出面板
• 服务端刷新批量清理缓存时不再卡住界面
• Mac 冷启动时播放条不再先闪一下音符再出封面
• iCloud 同步不再因一闪而过的退出登录事件被自动关闭
• 「更多」菜单的串烧播放改为一行显示，时长缀在括号里
• 百度网盘上刮削或编辑歌词不再误报写回失败
• Apple TV 记录启动方式与场景状态，便于定位启动停在启动画面
• Apple TV 启动时首页不再先空一下再出现内容
• 同步音乐源与封面功能的工程配置
• 校正曲库启动迁移校验
• 更新版本至 1.10.2（88）

Fixed

• 修复 Apple TV 构建因卡拉OK模型下载扩展缺少 arm64 声明而无法上传
• 修复二十多万首的大曲库在打开、滑动和后台听歌时因内存超限被系统关闭
• 修复 Emby 歌单同步请求超时
• 修复 Mac 打开歌词设置时闪退
• 修复 Apple TV 续播队列丢失、飞牛与群晖歌曲重复、自签 NAS 读不到音频参数与封面
• 修正歌词翻译词表的本地化检查
• 修复飞牛音乐歌单同步时部分歌单丢失
• 修复 Jellyfin 与 Emby 在多台设备、多个功能之间互相顶掉登录
• 修复 Apple TV 群晖扫描遇整轨 CUE 失败、续播列表出现重复歌曲，并整理专辑页与播放页细节
• 修复 Mac 开发版打开歌词设置仍会闪退
• 修复 Mac 版长列表在辅助功能执行「滚到底」时闪退
• 修复 Mac 侧栏「我喜欢的」与「搜索」之间间距过大
• 修复配置了内外网两个地址的音乐源，扫描途中服务器增删歌曲时会误删本地歌曲
• 修复 Mac 歌单大数字序号换行与列对齐
• 修复部分网图选作艺术家封面后显示成一块纯色 (#104)
• 修复电视端扫描复用和 Apple Music 起播异常
• 修复冷启动时首页顶部和播放器封面反复闪烁
• 修复 Apple TV 重扫读不到 CUE 分轨后来补上的歌词
• 修复 Apple TV 随机播放会抽到标成有声的目录里的歌
• 修复 Navidrome 等服务端源每次启动都被误判为文件已更换
• 修复缺省封面显示与曲库艺术家乱码
• 修复 macOS 列表大序号截断与列宽对齐
• 修复 macOS 构建时封面缓存清理的 Song 类型歧义

Performance

• 大曲库全部播放时队列只装一千首、快播完自动续上，启动缓存不再重复存整库歌曲，推荐改用紧凑索引，进一步降低内存占用
• Apple TV 播放页快切浏览不再卡顿，长按封面菜单补全
• Apple TV 重扫时跳过没有变化的歌曲，减少发热和收尾卡顿
• Apple TV 重扫完成时不再卡顿
• 冷启动时滑动首页、首次展开播放页和打开音乐源页不再卡顿

This release adds karaoke, audiobooks, and music medleys, expands audio/video formats and playlist import, adapts the whole app to iPhone Duo, and improves Home, Apple TV, and playback reliability.

Added

• Karaoke mode — lower the vocals, shift the key, split duet parts, and score and record yourself with the microphone; AI vocal separation downloads its model when you turn it on and removes the original vocals more cleanly; guide vocals step in when you stop singing; practice mode loops single lines and slows down without changing pitch; instrumental versions in your library are found automatically and reuse the original lyrics
• Karaoke on Apple TV — sing on the TV with an iPhone scanned in as the microphone for scoring, use AI vocals separated on iPhone, shift the key, and split duet parts
• Audiobooks — a bookshelf grouped by work and a dedicated player with chapters, bookmarks, speed, and sleep timer on all three platforms; a scrubber jumps through long chapter lists and books can be reordered by dragging; CarPlay and widgets support audiobooks, with a new Continue Listening widget; Apple TV adds chapter markers and speed control for every format
• Music medleys — start one in a single step from the player menu; the next segment is prepared before the transition and unplayable songs are skipped; starting on cellular warns about data use, and the reminder can be re-enabled in Settings
• Playlist import — import playlist links from NetEase Cloud Music, QQ Music, Kuwo, Kugou, Migu, Bodian, Soda Music, Apple Music, Spotify, Deezer, bilibili, and YouTube, as well as text lists, CSV, and Apple Music txt/xml, pls, xspf, and wpl files; songs not yet in your library stay greyed out and light up once they arrive
• More audio and video formats — MKA, WebM, MP2, Wave64, RF64, RealAudio, and tracker modules such as MOD, XM, IT, and S3M; music videos in MKV, WebM, AVI, FLV, WMV, TS, MPG, and RMVB are converted and cached on first play, with progress and failure reasons
• Tag suggestions and batch editing — the tag editor suggests fixes, can check the whole library at once, and can edit several songs together; smart tips appear during playback when relevant
• AI service presets — added SenseNova and Agnes AI, including Agnes AI (China) (#157)

Changed

• Home — filter Home by Music, Radio, or Spoken Word; Home editing now covers Continue Listening, radio, books in progress, and audiobooks, including which stations and books appear and in what order; the Mac bookshelf can also be shown on Home
• iPhone Duo — inner and outer displays, landscape grip, tabletop half-fold, and the system side bar are fully supported: two-column Home and detail pages, a split player, controls and Up Next on the lower half when half-folded, and elements that glide to their new place when folding or rotating
• Spoken word kept separate — audiobooks and music no longer bleed into each other, spoken-word chapters found in search play on their own, and listening positions are saved immediately, including when the Mac app quits
• Mac desktop lyrics — first opens just above the Dock; with the backing panel hidden, hovering the lyrics still reveals the toolbar (#149 #156)
• Full-screen playback — stage text fades out in rest mode instead of overlapping the clock and lyrics (#154); lyric translations appear without leaving and re-entering
• Bilingual lyrics — lines with only phonetic guides or other languages are still translated, and romaji, pinyin, and romanized Korean are no longer treated as translations
• Feiniu Music — lyrics prefer parseable candidates and keep the server's calibrated offset on iPhone, Mac, and Apple TV; tag write-back can rename albums, creates new genres, and uploads artwork; playlist indexes are read in one pass
• ReplayGain — volume no longer jumps when combined with crossfade, gapless playback, pause fades, or the equalizer
• Plain-HTTP radio — stations on hosts not yet allowed ask whether to trust them, then play right away once allowed
• Source scanning — Emby/Jellyfin and other server sources no longer fail when songs are added or removed mid-scan; checked sources use a reachable route when picking folders; the folder picker is redesigned and folders can be tagged as Spoken Word
• System notifications — sent only when a task you started finishes while you are outside the app

Fixed

• Playback — fixed a pause before sound when shuffling or playing all, and the Control Center and Lock Screen play button taking about ten seconds to update after pausing (#159)
• Karaoke — fixed a possible crash when changing songs, crashes when dragging the vocal slider or shifting the key, leftover vocals after seeking, and recordings stopping immediately when started while paused
• Remote connections — brief network drops when reaching a NAS from outside no longer interrupt playback or mark the whole source unavailable
• Tags — fixed unreadable track and disc numbers in m4a files, write-back overwriting unchanged fields, and a downloader's "(1)" suffix turning song titles into artist names
• Interface — fixed Home occasionally stuck on its loading placeholder after a cold launch, Home being widened by the listening chart in narrow iPad layouts, crashes when the system refuses a rotation request, and confirmation dialogs and adjustment panels being cut off on short screens
• Update check — new versions are detected again, and a manual check opens the update card directly
• Apple TV — fixed Synology verification not persisting, book artwork failing to load, and sluggish focus navigation in large libraries
• Wording — the Chinese Back and Next buttons no longer read as Previous and Next Image, and the radio management hints match the actual controls

Performance

• Player — opening and swiping away the player no longer stutters, and the More menu and smart tips no longer expand the whole queue
• Home and library — Home scrolls smoothly after a cold launch, and the library loads faster

This release redesigns key search and immersive-player interactions, adds spoken-word content and radio management on Apple TV, expands Apple Music, music-source connection, iCloud sync, and startup diagnostics, and fixes Mac full-screen playback, desktop lyrics, and several playback issues.

Added

• Editable search results — reorder or hide song, album, artist, and other result sections; Mac lays sections out side by side, and opening Search focuses the field immediately (#145)
• Apple Music system picker — add songs through the system picker, open the subscription flow when needed, and rematch tracks automatically after a storefront change
• Apple Music quality details — show actual Lossless, Hi-Res Lossless, and Dolby Atmos availability instead of labeling every track AAC
• Startup recovery and diagnostics — report the stage where startup stopped and enter safe mode after repeated failures; diagnostic reports now include system-exit reasons and connection candidates
• Dynamic detail backgrounds — album, artist, and genre detail screens use a full-page tint derived from their artwork
• Spoken word — audiobooks, crosstalk, and other spoken-word content are supported, and m4b audiobook files play directly
• Radio management on Apple TV — add, delete, reorder, and rename stations and browse the library on the TV; stations appear on the Top Shelf, and logos support SVG and music-source stations (#151)
• Custom lyrics servers — scraping can use a lyrics API server you provide and fetch lyrics online automatically when none are found
• Keep screen on — the player can keep the display awake, with the switch in Player settings (#154)
• Source health check — shows progress item by item and checks every connection route
• NonoEnd icon — a new bass-clef alternate icon; the default icon is now Soft Note

Changed

• Music source addresses — enter a Synology QuickConnect ID or Feiniu FN ID directly; Primuse resolves the port, TLS mode, and usable path, and an editable public source can be saved whenever its fallback address works
• Server playlist sync — newly created server playlists sync automatically without waiting for a manual scan (#142)
• Tag reading schedule — new tracks receive tags before full-library rechecks, WebDAV and NAS reads are faster, and desktop platforms use the fastest level supported by the device
• Immersive effect drawer — tap outside the drawer to close it on iPhone; Mac now uses a right-side preview drawer with more reliable full-screen transitions and window restoration
• Desktop lyric interaction — when the backing panel is hidden or locked, areas outside the lyrics pass clicks to the window behind, and the panel adapts to the display size (#149)
• Remote routing — stalled or failed LAN handshakes fall back to the public address instead of waiting out the full timeout; server sources re-confirm their route after a network change, and the health check no longer counts a proxy handshake as reachable
• iCloud sync — three-way playlist merging, deleted stations no longer come back, and very large playlists sync; turning on settings sync no longer overwrites other devices, device-specific hardware and storage options stay local, and device-only credentials are no longer migrated to iCloud Keychain
• Apple TV library snapshots — recorded per uploading device and merged by song; libraries sent over the local network are not overwritten by older cloud copies, and station edits made on the TV are preserved
• Full-screen effects — removed Light Rhythm and Live Waveform; the radial spectrum is centred on landscape and wide canvases
• CarPlay Up Next — shows artwork and follows the actual playback order
• Siri song requests — song titles are recognised more reliably, and Siri explains why when nothing is found
• Feedback entries — About now offers separate "Report a Problem" and "Feature Request" links that open a form with the version, device model, and OS already filled in and editable; only the description is required

Fixed

• Apple Music system state — fixed Lock Screen and CarPlay retaining the previous track after an automatic change, along with recovery, retry, and storefront-change issues
• Mac full-screen playback — fixed a disabled effect panel, top controls moving out of bounds or shaking, windows returning off-screen, and the player not tracking its container size
• Mac search and app icons — fixed stale counts after clearing search, the old Dock icon flashing at launch, and the default icon not being restored (#145 #146)
• Album grouping — tracks from one album are no longer split by track artist, and multi-disc albums keep disc and track order
• Connection and startup feedback — connections no longer spin forever on failure, startup and source setup report actionable causes, and server addresses and paths are redacted from logs
• Lyric editing — write-permission checks no longer stall, and editing an M4A with grouping metadata preserves its embedded lyrics
• Memory pressure — artwork caches are released first when memory is tight, reducing the chance of system termination
• Safe mode false alarms — launches the system starts in the background (scan resume, silent push) are no longer counted as aborted launches and can no longer lock the app into safe mode; a wrongly latched safe mode is cleared after updating
• Feiniu playlist and favorite sync — empty server lists no longer fail with “not valid Feiniu Music JSON”, and unpaged playlist indexes are read correctly
• Playback — fixed radio not playing on Apple TV, playback stopping after one song with crossfade on, and a few songs without a readable duration being re-read endlessly and slowing the interface
• Lyric highlighting — fixed the original line not highlighting in mixed-language lyrics such as Korean with English
• Music sources — fixed connection failures from a protocol option out of sync with the address, Synology password editing and re-authentication, songs remaining after a folder is unchecked, and 123 Cloud tag write-back reporting failure while the server is still merging
• Interface — fixed a crash from Home folders "See All", the old two-column player in landscape on Plus and Pro Max models, and stutter while scanning or editing a music source

Performance

• Sources and Home — faster WebDAV/NAS tag reading, smoother large radio libraries, and more responsive switching between Music and Radio on the Home screen
• Diagnostic privacy — connection candidates and failure stages remain useful for troubleshooting while server addresses, paths, and other sensitive values are replaced by stable markers

This release adds Guangya Cloud, Synology Audio Station, full radio organization, and more lyric formats, brings Apple Music into the unified music source list, and overhauls landscape layouts, Apple TV decoding, server synchronization, and cross-device transfer.

Added

• Guangya Cloud music source — add Guangya Cloud as a music source, with scanning and playback working like any other source
• Lyric poster sharing — turn selected lyrics into a shareable poster image, with adjustable layout and colors
• Cloud drive folder browsing — the cloud drive folder hierarchy is rebuilt and music sources gained a folder entry, so you can browse by the original directory structure (#109)
• Manual playlist ordering — press and hold a track in a playlist to drag it into a new position
• Shuffle shortcut — a shuffle button is now available at the top of the song list and the playback queue (#115)
• Diagnostic log export — TestFlight builds can export runtime logs from Storage Management
• Radio folders, tags, and subscriptions — organize stations with folders and tags, import grouped playlists, subscribe to playlist URLs, provide image URLs, and display SVG logos (#118 #119)
• Synology Audio Station — add Synology Audio Station on iPhone, iPad, Mac, and Apple TV, with songs, playlists, favorites, and SHOUTcast stations synchronized
• More synchronized lyric formats — ID3 SYLT, .elrc, .lys, .yrc, .qrc, .vtt, and .srt, preserving offset, duet, harmony, translation, and romanization data (#125 #128 #129 #130 #131)
• Embed lyrics in audio — save edited synchronized lyrics only inside the audio file or alongside a sidecar, with a file-write warning before enabling it
• Network-adaptive quality — Subsonic, Emby, and Jellyfin can use transcoded quality on mobile networks and support reverse-proxy path prefixes (#126 #135)
• New icons and interface motion — added adaptive icon themes and a consistent motion system across navigation, cards, lists, artwork, and playback controls

Changed

• Apple Music in the music source list — authorization, library sync, and removal all happen in the music source list, so Apple Music can be added and removed like any other source; once removed, its content no longer appears in search (#112)
• Scanning continues after leaving the app — a scan keeps running after you leave the app and resumes where it left off when you return (#99)
• Server-side deletion sync — tracks deleted on the server are removed locally, and sources that do not support deletion now only drop the local record (#107 #103 #95)
• Tag reading backs off — tag reading slows down automatically when a server returns 5xx, and WebDAV requests and responses are recorded for troubleshooting
• Music source icon colors — each music source icon now uses its own brand color
• Device transfer layout — the primary action moved to the navigation bar, leaving more room for the list
• Lyric annotations and translations — annotations and translations are laid out together with the original line, and foreign-language lines in mixed-language songs are highlighted again
• iPhone landscape layouts — Home, Now Playing, lyrics, detail pages, grids, and settings panels adapt to landscape height while rotation and foldable transitions preserve the current page
• Apple TV compatibility decoding — tvOS gained the FFmpeg path for WMA, DTS, TrueHD, and other formats unsupported by native decoders
• Incremental server synchronization — media servers and Subsonic-family sources stream large catalogs into the library, resume after interruption, and synchronize server tags, artwork, ratings, and deletions
• Complete offline cache — offline downloads include server lyrics and artwork, while cached tracks remain playable when their source is temporarily unreachable
• Chunked Apple TV transfer — large library snapshots transfer in stages with visible progress, reducing attached artwork automatically when a payload would exceed the receiver limit
• More efficient iCloud sync — large playlist and library batches no longer rewrite entire records one by one, and upgrades or restored backups avoid unnecessary full reuploads

Fixed

• Embedded artwork — fixed embedded artwork that could not be read for some tracks after a bulk import and could never be recovered afterwards (#116)
• External and remote connections — fixed external music source connections failing and crashing the app, along with fnOS remote connections and their error handling
• IPv6 addresses — fixed IPv6 music source addresses failing to connect and directories failing to load
• Playback queue reordering — fixed a crash while dragging to reorder; with shuffle on, automatic track changes now match Play Next after reordering (#108)
• Lyric poster layout — fixed blank poster previews and clipped layouts
• Quick favorites editing — fixed slow opening and laggy input when editing quick favorites
• Playback speed — fixed the playback speed control failing to open
• macOS window buttons — fixed the window buttons in the top-left flickering while scrolling
• Playback stability — fixed occasional crashes when starting playback, stale audio after resume or track changes, replaying a remote track waiting for a full download, and manual skips missing the configured fade
• Music source recovery — fixed public sources being marked offline, reverse-proxied WebDAV folders failing to load, SMB timeouts crashing, and deleted then reimported local or remote tracks being unable to return (#111 #134)
• Artwork and posters — artwork can be rebuilt after clearing its cache; lyric posters save to Photos again, with motion effects available in every poster style
• Apple TV and iCloud — fixed overlapping intelligent-settings screens, iCloud failing to refresh more than once or still exchanging data after being disabled, and missing sync failure details (#123)

Performance

• Large server catalogs — media servers and Plex use paged staging and resumable scans so large libraries no longer slow down as the scan progresses
• Radio and library — optimized large station collections and Home switching while reducing repeated view recomputation
• App size and runtime memory — reduced Year in Review and icon-preview assets, shared the database layer between the app and widgets, and avoided repeated full-library saves during startup, playback, and metadata backfill

This release lets Apple TV add nearly every kind of music source and play Apple Music directly, brings in-place visual editing to the home screen and CarPlay, overhauls the immersive visuals, and systematically addresses large-library scanning, tag-reading heat, and several concurrency problems.

Added

• Music sources on Apple TV — add and scan Synology, QNAP, UGREEN, WebDAV, FTP, SFTP, NFS, S3 object storage, UPnP, and every cloud drive directly on Apple TV (cloud drives now sign in by QR code), along with Jellyfin, Emby, Plex, and Subsonic-family servers, complete with error reporting, two-factor verification, and self-signed certificate trust
• Apple Music on Apple TV — play Apple Music directly, search the catalog, albums, and artists, see Apple Music playlists in the playlist tab, and authorize from the search or settings screen
• In-place interface editing — lay out the interface on the real screen: rearrange each home screen section and adjust item and row counts, with appearance settings grouped by screen
• CarPlay layout editing — edit the CarPlay layout visually and save custom presets, customize the main menu, and use the rebuilt settings grouping and drag editing
• Immersive visuals overhaul — the immersive styles were rebuilt with five new scenes, and the spectrum returns in high-fidelity passthrough
• Ratings and reviews — rate and review from the library, with improvements to listening charts
• Station logos and live metadata — station logo sources are resolved automatically with live metadata during playback, logos appear when adding stations in bulk, and can also be fetched by hand
• Server playlist and favorite sync — fnOS, Songloft, Jellyfin, and Plex gained server-side playlist and favorite synchronization
• VPN and Tailscale routing — network routing accounts for VPN and Tailscale, with corrected IPv6 address handling; adding a public address to a source leaves existing playback and offline cache intact
• STRM redirects — support for media server STRM redirects, with better remote cache retries
• Whole-song lyric alignment — lyric timing can be aligned across the whole song, with time conflicts flagged
• Sleep timer — the radio player gained a sleep timer
• Tag reading gears — reading gears stay in effect after the device heats up, and a pause gear was added
• Tag check details — the detail screen was redesigned with consistent cards and a status distribution bar
• Email a diagnostic report — send a diagnostic report to the developer straight from the report screen
• WebDAV restricted deletion — when the server does not permit deletion, only the local track is removed

Changed

• Product name — the product name is now Primuse everywhere, with 猿音 kept as an alias you can still invoke
• Tag reading pace — full-speed reading shows a prominent risk warning first, one extra read slot is granted during playback, and measured throughput is logged along with the limits in effect; background time reclaimed by the system is no longer reported as a read failure; re-reading all tags now runs directly, with per-source re-reads moved to a long-press menu
• Large library startup and scanning — faster startup and genre index loading, fewer checkpoint disk writes while scanning, and scan state loading, backfill reconciliation, and the streaming write lock no longer occupy the main thread
• Playback pipeline — buffer scheduling moved off the main thread so scrolling no longer follows the decode rhythm; the player queue and audio routing were rebuilt; in high-fidelity passthrough the volume bar defers to the output device's hardware volume
• Duplicate cleanup — no longer deletes WebDAV source files, and same-name tracks with incomplete tags are no longer cleaned up by mistake
• macOS song list — the top area stays fixed while scrolling, the header is pinned, and sorting and column layout improved
• Settings cleanup — groups were reordered with lyrics as their own category, scattered menus merged, and theme colors and app icons laid out as tiles
• Apple TV interface — the credential screen dropped its outer frame and explains that passwords can sync from the phone, text scales with the system size, and charts, folders, artists, transfer receiving, and scan folder selection render page by page
• Detail transitions — album, playlist, and artist detail screens now expand from their card
• Lyric spacing — a line and its translation sit closer together, with more space between lines
• Sources not yet offered — fnOS and UGREEN are no longer listed when adding a source; both are waiting on a public vendor API
• Other — improved the iPad capsule player layout, home screen cache reuse, music source scroll bars, and the on-state backing for the shuffle and repeat buttons; artist images fall back to track artwork, automatically fetched station logos no longer overwrite manual ones, albums in one folder are no longer split by track artist, and a failed source is no longer probed repeatedly

Fixed

• Garbled tags — fixed garbled and truncated album tags and artist fields bleeding into each other, along with parts of metadata backfill
• Large library scanning — fixed scanning not resuming after returning to the foreground, fnOS large-library scans hanging and rebuilding repeatedly, scans not recovering after a backoff, tracks being lost and retried endlessly when a folder errors, tracks being removed when a shared folder becomes unreachable, and WebDAV rescans deleting tracks
• Concurrency — fixed library index rebuilds being dropped, backfill patches overwriting each other, and persistence starvation, plus conflicts between background metadata recovery and the streaming cache and races in source background task registration and cache cleanup
• Endless loading on internal HTTPS — fixed the certificate confirmation prompt never appearing, which left internal HTTPS sources stuck loading forever
• Interruptions and track changes — fixed Apple Music skipping tracks in a row and not advancing at the end of a track, the current track going silent seconds after toggling shuffle, and the player staying stuck on loading after a remote stream stalls
• Queue dragging — fixed a crash while dragging the queue; the drag handle was removed in favor of a long press on the row
• Listening stats — fixed inflated play counts and durations; actual listening now accumulates from real playback increments
• DLNA — fixed a listener restart storm and log backlog that crashed the app, and isolated the retry task lifecycle
• Duplicate detection — fixed same-name tracks from different albums being treated as duplicates, along with source file deletion and permission recovery
• Blank settings screens — fixed returning from a sub-item to a blank page and the Apple TV entry opening blank, made theme colors and app icons reachable again, and restored the page after leaving settings search
• CarPlay artwork — fixed artwork missing from lists and flickering between placeholder and real artwork
• macOS widgets — fixed artwork breaking the layout, and the label now reads paused while paused
• Lyric highlighting — fixed the highlight landing on the translation when word-level source text and a whole-line translation share a timeline, and wrapped lines no longer highlight both rows at once
• Apple TV — fixed shuffle, two-factor verification state and NFS folder reads while scanning, cloud drive QR authorization, whole-library playback and network probing on the home screen, the remote becoming unresponsive in long lists, missing reasons after a failed verification, and a NAS certificate trust loop
• Energy use and foldables — fixed log write amplification and a cache cleanup loop, lowering playback energy use, and adapted the layout for foldable screens
• Other — fixed a blank top artists section on the home screen, folder classification and a crash when opening a folder, FN Connect access code handling and reconnection failures, custom artwork occasionally disappearing on refresh, users being asked to rate again after rating, and Apple Music sync after a store region change

Performance

• DTS playback — the decoder aggregates output buffers at native granularity, removing scrolling stalls during DTS playback
• Lists and statistics — fixed main-thread stalls while playing and scrolling the song list, and stalls when switching listening stats and rendering the macOS calendar

This release adds local network device transfers with web-based management, makes local music available in the Files app, introduces the Songloft music source and nine new languages, and greatly speeds up tag reading.

Added

• Device transfers — move music between devices on the local network, picking tracks from the library or managing them from a web page; an iPhone can also send its cached audio to a nearby device
• Files app access — local music can be reached directly in the Files app
• Songloft music source — support for Songloft, including playlist and radio sync
• Nine new languages — nine more interface languages, with localization completed across platforms
• Live lyrics activity — live lyrics on the Lock Screen and in the Dynamic Island
• Listening stats — the macOS listening calendar gained duration trends and time-of-day breakdowns, and song details show the server-side play count
• Search scope switching — search can switch scope and context, with a dedicated button
• Artist image completion — missing artist images are filled in automatically
• macOS folder browsing — macOS gained a folder browser and folder detail views
• Quick access artwork style — the artwork style of the quick access section can be configured
• Bulk tag re-read on Apple TV — tags can be re-read in bulk on Apple TV

Changed

• Faster tag reading — SMB tag reading is substantially faster and keeps running in the background, the speed can be adjusted, and full-speed mode gained protection, cooldown, and task recovery, with clearer error reporting
• Transfer experience — track selection moved to a tree view, scrolling and loading hold up in large libraries, receiving reports progress and results, transfers can no longer be dismissed by accident, and the switch bar and controls share one style
• Library browsing — unified search and detail layouts, improved album results and browse switching, a tighter artist header with consistent album detail cards, and refinements to artist details and genre browsing
• WebDAV tag backfill — tags are backfilled on demand while a WebDAV track plays
• Lyrics compatibility — support for bracket-style word-by-word lyrics, and older lyric caches are restored
• Removing local sources — refined the file cleanup rules when a local music source is removed
• Network playback overhead — fewer repeated downloads and less background indexing work
• macOS interface — improved player navigation and progress interaction, tool entries and default artwork, the waterfall layout of music source cards, and the server listening stats layout

Fixed

• Remote playback — fixed interruptions, wrongly skipped tracks, and the position jumping backwards
• Apple Music launch hang — fixed the app hanging at launch while loading artwork
• WebDAV disconnects — fixed a crash caused by continuing to read after a disconnect
• Cloud drive folder browsing — fixed folders being unbrowsable right after authorization
• Internal/external switching — fixed business errors being confused when a music source switches between internal and external networks, along with network detection and bulk re-reads
• Album artist detection — fixed album artist detection and improved browsing of recently added albums
• Volume snapping back — fixed the volume snapping back when adjusted while paused
• Minimal mode — fixed page spacing and the player covering content
• Tag reading failures — isolated read failures and lowered the detail screen's overhead, and corrected the speed shown after switching gears
• Apple TV — fixed library scanning, syncing, and playback
• macOS folder navigation — fixed folder navigation and improved the player's information display

Performance

• Tag reading scheduling — the high-performance read entry moved to the music source and adapts to device capability, with improvements to the Apple TV queue

This release adds end-to-end encrypted music sharing, Smart Mix beat-matched transitions, and streaming smart playlists, connects to China Telecom Cloud, and fixes wireless output and lost player state.

Added

• Music sharing — any readable source can produce a secure playback link, with short codes, permanent links, guess-resistant protection, and end-to-end encryption; use the built-in service or host your own, with Cloudflare relay and dual-mode deployment
• Smart Mix — analyzes beats and blends tracks with segmented transitions
• Streaming smart playlists — smart playlists fill in as they generate, the recommendation queue updates with the stream, and already-generated results survive a source switch
• China Telecom Cloud — support for China Telecom Cloud, including protocol integration and security validation
• Local network cache sync — sync audio cache to a chosen device on the local network
• Refresh lyrics from the source — pull lyrics again from the music source, with translation fields and safe editing
• Widget lyrics — widgets display long lyrics and stay in sync with playback
• Swipe for queue actions — swipe in the song list to act on the playback queue
• macOS search filters — filter search results by song, album, artist, or lyrics
• Standalone playback on external devices — external devices can play audio on their own
• Multichannel M4A — system audio playback supports multichannel M4A
• Navidrome scan at launch — scans at startup, and playlists keep an offline copy automatically

Changed

• Minimal mode — rebuilt the top navigation and floating player, with adjustments to the home screen, search, and settings, and smoother detail transitions
• Music source fingerprints — security fingerprint checks are consistent across platforms
• DLNA — speaker discovery and the receive switch are now independent
• System Now Playing — line-by-line lyrics are enabled by default
• Apple Music interruptions — added an audio session interruption policy with better handling and recovery
• Apple TV immersive playback — the screen stays awake during immersive playback
• Deleting large sources — improved cache reclamation when removing a large music source
• Local scanning and backfill — improved local scanning and metadata backfill, with fewer redundant writes of source sync state
• Siri guidance — refined the example phrases and added guidance for requesting a specific song

Fixed

• Wireless output — fixed silence and noise after the wireless output configuration changes, and corrected audio focus when AirPlay returns to the device (#80)
• Lost player state — fixed the player being cleared after a long spell of background playback, and state being lost on an automatic track change
• Playback clock crash — fixed a crash in the playback clock after an audio interruption
• Navidrome track changes — fixed consecutive track changes getting stuck loading
• Cache deadlock — fixed a concurrency deadlock in the remote streaming cache
• Folder selection hangs — fixed hangs during multi-protocol folder selection and when deleting a recent music source
• Cache cleared on upgrade — fixed the audio cache being wiped during an upgrade
• Player interaction — fixed a progress bar that could not be dragged and a stall when first expanding the player
• Batch action bar — fixed the batch action bar being covered by the tab bar
• Lock Screen lyrics — fixed lyrics occasionally missing on the Lock Screen and in widgets
• Recommendation queue — fixed playback stopping at the end of the recommendation queue
• DLNA discovery — fixed devices not being found when several network interfaces are present
• Remote lyric writeback — fixed read-back validation after writing lyrics
• Disabled music sources — fixed the queue still trying to play from a disabled source
• Guest credentials — fixed scan state becoming incompatible after switching credentials on a guest source
• macOS window notifications — fixed a concurrency crash in window notifications
• Apple TV — fixed focus jumps in the top tabs, playback recovery, and Subsonic lyric loading
• Other — fixed media server library folder classification, home screen radio artwork loading, Daoliyu playback not preserving the original audio, and internal source identifiers leaking into scraper search results

Performance

• WebDAV scanning — lower scanning load, with a faster tag detail screen

This release expands intelligent services with multi-vendor support and cross-device sync, adds server-side listening stats and audio transcription, and polishes word-by-word lyric display and alignment.

Added

• Multi-vendor intelligent services — support for several protocols and vendors, with model lists fetched online, automatic fallback when a service is unavailable, and settings synced across devices
• Built-in intelligent service — a built-in service protected by device verification, usable without configuring your own key
• Smart recommendations — the library generates recommendations by scenario, themes can be reviewed and deleted, and the home and recommendation areas show loading skeletons
• Audio transcription — transcribe a track's audio and use it to improve recommendations
• Server-side listening stats — read listening statistics from supported music services, falling back to a cached snapshot when offline
• Custom lyric colors — lyric colors can be customized, including gradients
• Artist artwork — artist artwork is detected automatically and can also be set by hand
• Multi-artist parsing — split multiple artists by rule, with protection for names that should stay intact
• Dynamic album artwork — support for animated album artwork provided by a source
• Radio with Siri — search for and play stations with Siri
• Bulk clear recently deleted — safely empty recently deleted items in bulk
• Navidrome auto-refresh — refreshes when the app returns to the foreground, and playlists always keep an offline copy

Changed

• Intelligent service settings — the settings screen was rebuilt with a consistent look on every platform, further simplified on phones, with clearer wording, separate test and production environments, and an explicit note that an OpenAI API key is not a ChatGPT subscription
• Request scheduling — improved quota feedback and request scheduling, with background recommendation refreshes limited
• Multi-format tag reading — more file formats are supported, with diagnostics for failed reads
• Background tag completion — each pass is bounded so it no longer runs long
• Lyrics and immersive visuals — rebuilt the full-screen lyric layers and multi-layer text field, refined the immersive text animation and exit flow, and smoothed the flowing lyrics on the title wall
• Tag check details — redesigned the mobile layout, simplified the information hierarchy, and distinguished the "not fully checked" state
• Playlist import — moved into the library actions
• Search — keyword path search and intelligent results now coexist
• macOS interface — the app name no longer appears in the title bar, and long song lists scroll more smoothly

Fixed

• Word-by-word lyrics — fixed word truncation and layout for right-to-left languages, highlight jitter in Persian, the first line highlighting early during an intro, delayed highlighting across ELRC silent gaps, interrupted highlighting on overlapping vocal parts, and the next track's lyric progress during a crossfade
• Lyric language and translation — fixed misdetected languages causing the translation prompt to block repeatedly, and lyrics without a language tag now lay out in the right direction
• Intelligent service connections — fixed built-in service authentication and device verification, DeepSeek endpoint authentication and unresponsive structured generation, and added connection diagnostics
• Tag reading — fixed backfill not starting after a cloud drive scan, local read failures reporting nothing, cloud re-reads marking valid audio as invalid, and overheating caused by background reads
• Startup crash — fixed a crash at launch when the library contains duplicate artists, along with stalls and a toolbar crash on the artist detail screen
• Background indexing — fixed the library background index running under sustained high load
• Apple Music startup sync — fixed stalls caused by syncing at launch
• Remote sources — fixed paths with special characters and form encoding, plus DTS duration detection and migration of historical data
• Playback position — fixed seeking having no effect while paused
• macOS — fixed a misplaced and disappearing title bar, stalls when scrolling and loading long lists, wrapped track numbers in the song list, a regression in native widget configuration, and widget play buttons that could not be tapped directly
• Apple TV — fixed focus and remote interaction, and improved music source and library responsiveness

This release brings word-by-word lyric timing and a unified immersive player across platforms, adds intelligent services with semantic search and direct local file references, and resolves HTTPS certificate handling, large-library stalls, and invalid music sources being saved.

Added

• Word-by-word lyric timing — adjust the timeline word by word, with a scrolling policy for long instrumental gaps, plus Lock Screen lyrics and native favorite actions
• Immersive playback — a unified immersive full-screen player on iPhone, Mac, and Apple TV, with a redesigned real-time waveform, a queue-driven title wall, and customizable visual effects
• Intelligent services and semantic search — extensible intelligent services backing a non-blocking semantic library search, with results ordered by best match
• Direct local file references — reference local files and folders directly with persistent authorization, and referenced folders sync automatically
• Custom album and playlist artwork — replace album and playlist artwork with your own
• Theme color from artwork — the theme color follows the current artwork on all three platforms
• Server radio sync — sync stations from the server, including Subsonic station artwork
• Two-way favorite sync — favorites sync both ways with Emby and Navidrome, rolling back on failure
• Google Drive folder selection — authorize through the Google Drive Picker and choose folders
• Baidu Netdisk snapshot sync — snapshot synchronization for Baidu Netdisk sources
• WebDAV tag writeback — audio tags and artwork can be written back to WebDAV sources
• Song list sorting and alphabet index — sort the list and jump with an alphabet index
• Delete from the playback queue — remove tracks directly in the queue, with stronger drag feedback (#40)
• macOS library navigation — detail views open inline, the playlist grid adapts to the window, and playlists can be managed from the sidebar
• SMB scan folders — pick an SMB leaf folder or the share root as the scan target
• Volume slider visibility — choose whether the volume slider is shown

Changed

• Boundaries for intelligent services — device-specific credentials no longer sync to the cloud, API keys are isolated per service address, plaintext connections are limited to private addresses, requests have timeout and response size limits, and stale results are dropped when the store region changes
• Recently deleted — the retention period is now 30 days everywhere
• Consistent player appearance — themes and immersive playback look the same across platforms, with adjusted radio colors and a tvOS dual theme
• Lyrics display — improved alignment and blur, with depth of field on non-current lines
• Audio cache — refined the cache size limit and shutdown behavior
• Bluetooth and CarPlay — better Bluetooth playback, with improved CarPlay playback and interface management
• Insecure connection warnings — completed the localized warnings for plaintext HTTP
• macOS and iPad interaction — improved macOS back navigation and batch actions, restored the iPad player's track-change gesture, and shrank the control icons on the expanded mini player

Fixed

• HTTPS certificates — fixed the certificate prompt blocking playback from internal sources, falling back to the public endpoint after a certificate renewal, self-signed WebDAV certificates that could not be confirmed, and trusted sources stalling after a certificate change
• Invalid music sources being saved — a source is no longer created when SMB verification fails, a Jellyfin configuration is invalid, or media server authentication fails; cancelling a new WebDAV source leaves nothing behind, and deleted sources no longer come back
• Audio interruption recovery — fixed wrongly skipping tracks and auto-playing after an interruption, playback now resumes after a long interruption, and the playback session is no longer lost at startup
• Remote playback downloads — the first track after a cold launch no longer waits for a full download, seeking no longer stalls on a complete download, and a single track download is no longer shown as caching the whole source
• Lyrics compatibility — fixed right-to-left lyrics, plain-text lyrics disappearing after a rescan, and recognition and encoding of embedded lyrics in ALAC/M4A files
• Artwork recognition — valid embedded artwork is no longer rejected as incompatible, compilations group by album artist, a missing album cover falls back to the track cover, and playlist artwork resolves the same way on every platform
• Baidu Netdisk — fixed library identity and refresh safety after a file is moved, reconciliation when a file is replaced in place, and successful writebacks being reported as failures
• Google Drive — hardened sidecar writes, and fixed multi-format lyric writeback and scan folder authorization
• Navidrome over the public network — fixed authenticated playback of tracks that are not cached, and interrupted incremental refreshes with missing folders
• Apple TV — fixed a cold-launch crash caused by the dynamic theme color, slow appearance switching, storage capacity checks, and focus styling for the play button and search
• macOS windows — restored the native window control buttons and the title bar button container, and made the sidebar resizable again
• Full-screen player — fixed the exit interaction and touch input after rotation, along with the effect picker size and progress bar position in landscape
• Background maintenance — fixed maintenance tasks waking repeatedly, and isolated them from local source sync
• Other — fixed a write-permission precheck that never finished, selection and delete protection during duplicate cleanup, an incorrect high-fidelity output sample rate, tag backfill not retrying after a source recovers, and the iPad player covering content while the artwork picker closed immediately

Performance

• Large libraries — shorter cold launches, less contention while resolving metadata, and fewer stalls in the foreground and when switching between foreground and background
• Long lists and large queues — improved rendering of large song lists and alphabet index jumps, and fixed high CPU use from a failing source in a large queue
• Incremental merging — lower memory use when merging library changes, and faster playlist artwork generation

This release adds server playlist sync and folder browsing, brings batch actions to the song list, and introduces smart transitions with silence skipping.

Added

• Server playlist sync — playlists from Jellyfin, Emby, and Plex are mirrored locally and kept in sync
• Folder browsing — browse songs by the folder hierarchy of their source, including cloud storage directory structures
• Batch actions — select multiple songs in the list and act on them together
• Smart transitions and silence skipping — smooth transitions between tracks, with leading and trailing silence skipped automatically
• Swipe the mini player — swipe left or right on the mini player to change tracks
• Apple Music playlist hierarchy — the Apple Music library is presented by playlist
• WebDAV media redirects — playback can follow a redirect to a CDN, easing load on the origin server
• Lyrics format conversion — convert between lyrics formats, with better detection of the format in use
• Media server lyrics — stronger lyrics support across several media servers
• Radio visibility on the home screen — choose whether the radio section appears on the home screen
• macOS keyboard shortcuts — shortcuts can be customized

Changed

• Large queue rendering — improved rendering of very long queues, and added a folder playback entry
• Large library sorting — sorting now reports progress
• Player controls — unified button sizes and layout on the player screen
• Apple Music caching — improved the playback cache strategy and search focus handling in the title bar

Fixed

• Garbled file names — fixed recovery of garbled names for cloud drive tracks, so song details no longer misjudge their state
• Deleted playlists coming back — a deleted playlist is no longer restored by server sync
• WebDAV reverse proxies — fixed directory reads and media redirects behind a reverse proxy
• MP3 duration — fixed MP3 duration calculation and its retry logic
• Batch action boundaries — hardened batch actions and deletion boundaries, and improved folder multi-selection
• Large library sorting and selection — improved sorting and multi-selection in large libraries, with an adjusted batch action bar
• Saving re-timed lyrics — fixed scraped lyrics failing to save after being re-timed
• Cloud drive scanning — hardened cloud drive scanning and metadata backfill
• Playback intent and interruption recovery — unified playback intent and the state restored after an interruption
• macOS Now Playing — fixed a crash on the Now Playing screen, and restored the spacebar playback shortcut

This release adds a localized interface and Siri voice requests, makes the theme color customizable, and gives the home screen separate music and radio modes.

Added

• Localized interface — in-app text is localized and follows the system language
• Siri requests for local music — ask Siri to play tracks from your local library
• Custom theme color — pick a theme color, or pin it so it no longer follows the artwork
• Home screen modes — switch the home screen between music and radio, with the radio wall adapting to screen orientation
• Adaptive connections — a music source can hold several endpoints and picks whichever one works on the current network
• Favorite from the Lock Screen — mark a track as a favorite straight from the Lock Screen widget
• Drag to reorder the queue — reorder the playback queue by dragging
• Full-screen lyrics editing — edit lyrics in full screen, including multi-language lyrics
• Remote WAV playback — improved playback support for remote WAV files

Changed

• Simpler music source setup — connection preferences were removed; adaptive connections decide how to reach a source
• Lyrics editor — the editing interface and its playback sync were rebuilt
• Buffering and album scraping — improved buffer management, and album detail pages can trigger scraping directly
• Scan progress — scan progress is clearer, and cloud sync errors are reported honestly
• Rating prompt — adjusted when the App Store rating prompt appears, with improvements to backups

Fixed

• Cloud music sources after upgrade — fixed some cloud music sources not being restored after an upgrade
• Offline cache and Navidrome scanning — fixed the offline cache and sped up Navidrome scans
• Public HTTP and endpoint trust — improved compatibility for public HTTP connections and endpoint trust
• Radio management — stations can be managed directly from the list
• Song sorting — smoother interaction while sorting
• Repeated tag reads — server libraries no longer read the same track's tags repeatedly

This release brings internet radio to iPhone, Mac, and Apple TV, and adds incremental sync and STRM support to the library.

Added

• Internet radio — listen to internet radio across Apple platforms, with prioritized station browsing that makes stations easier to find
• Incremental sync and STRM — the library supports incremental sync and recognizes STRM files

Fixed

• Synology scanning — fixed scanning with two-factor verification and over public HTTP
• Scan error reporting — a failed music source scan now shows the real reason instead of a generic error
• Player screen — improved interaction and startup speed on the player screen
• Car display artwork — artwork shown in the car now matches the current track

This release adds immersive lyrics, lyrics editing, and the Drime cloud drive, plus Synology QuickConnect and fnOS FN Connect remote connections.

Added

• Immersive lyrics — a landscape full-screen lyrics mode with its own playback controls, and full-screen music videos
• Lyrics editing — edit lyrics directly and write them back to the source
• Drime cloud drive — connect to and play from Drime, including writes, deletions, and permission handling
• Synology QuickConnect — QuickConnect picks the best way to reach the server
• fnOS FN Connect — connect remotely through FN Connect

Changed

• App icon — the icon system and its theme configuration were rebuilt

Fixed

• Plain-text lyrics — fixed highlighting and tap behavior for plain-text lyrics
• ELRC lyrics — improved ELRC synchronization and auto-follow
• Remote playback — fixed silent remote playback, and a dropped stream skipping the whole track
• Playback session recovery — the playback session is restored and the system playback state stays in sync
• Now Playing artwork — cached artwork refreshes properly, and switching between lyrics and artwork works again
• Home screen on launch — improved the launch home screen and library artwork presentation

This release adds the Daoliyu and fnOS Music sources, improves how scraping candidates are ranked and reported, and fixes a range of Synology playback, credential, and cross-device sync issues.

Added

• Daoliyu music source — Daoliyu can now be added as a music source
• fnOS Music source — support for fnOS Music, including a direct connection to the standalone app, with improved credential handling
• Apple TV transfer — a more complete transfer flow to Apple TV, with clearer error reporting

Changed

• Playback buffering — the buffer is now bounded by both duration and item count, with matching work on the playback service and decoder
• Scraping candidate ranking — manual scraping candidates are ranked by duration and match quality, with an accuracy hint
• Remote tag reading — remote tags are parsed in memory, cutting disk writes and repeated downloads
• NFS connections — the NFS client and its connection management were rewritten

Fixed

• Synology playback — fixed DTS failing to recover after an interruption, next-track pre-caching not working, and incorrect DTS durations, along with metadata and queue advancement
• Gapless playback — fixed track duration being lost during a gapless transition
• Mixed queue continuation — a failing source no longer stops the whole mixed queue
• Playback progress — fixed the playback position being displayed incorrectly
• Remote artwork — fixed the system Now Playing view failing to load artwork for cloud drive tracks
• Credential storage — fixed credentials failing to save, and corrected the background on an external display
• Public HTTP connections — trusted NAS devices can connect over public HTTP
• Subsonic compatibility — improved authentication and response parsing for compatible forks
• Scraping writeback — read-only sources are no longer asked to write scraping results back
• NAS metadata refresh — NAS metadata is refreshed and the outcome reported honestly
• Automatic scraping matches — fixed matching for structured file names
• Lyrics position — fixed the current lyric line after scraping finishes
• Large tags — fixed reads failing on very large ID3 tags and on files with a trailing moov atom
• Apple Music imported library — imported library content now plays correctly
• Playlist batch scraping — batch scraping now reports progress and results
• Duplicate cleanup — fixed how read-only files are handled during cleanup
• macOS title bar — fixed dragging and double-click zoom on the title bar
• macOS search and lyrics — the search field is centered and the lyrics player can be collapsed
• iOS volume bar — fixed the volume bar layout, and cellular data notices no longer repeat
• Player appearance — fixed artwork-based theming and light/dark switching
• tvOS artwork fallback — smoother fallback between placeholder and real artwork
• Apple TV snapshots — fixed a failed snapshot being reported as successful
• Large library loading — improved responsiveness when loading large libraries and translating lyrics

This release brings CUE sheet and DTS playback on a high-fidelity decoding pipeline, along with a round of fixes for playback queues, lyrics, CarPlay, and Apple Music.

Added

• CUE and DTS playback — play CUE-split albums and DTS audio through the high-fidelity FFmpeg decoding pipeline
• Delete playlists on iPhone — playlists can now be deleted directly on iPhone

Changed

• Audio decoder rework — the decoder can start from a given time and applies backpressure flow control, making seeking in long tracks more reliable
• Now Playing scraping and lyrics — metadata scraping is now a single entry point, with matching adjustments to the lyrics display
• Quick favorites — quick favorites can be reordered, and turned off entirely

Fixed

• Duplicate track-end handling — fixed a track's end triggering the next-track logic more than once
• Shuffled and mixed queues — fixed shuffled and mixed-source queues stopping partway through
• Apple Music queues — fixed queues failing to advance, preserved mixed queues and manual scraping results, and kept official artwork while scraping lyrics
• Lyrics display — added a fallback when lyrics cannot be fetched, and stopped the lyrics view from jumping around
• CarPlay — fixed duplicate Now Playing templates, and artwork the server returns in an incompatible form is now converted first
• Subsonic lyrics — the lyrics endpoint is chosen by server capability, so compatible forks no longer come back empty
• Concurrent playlist edits — playlists edited on several devices at once no longer overwrite each other
• macOS song actions — fixed the context menu acting on the wrong track, and restored local folder scanning
• Volume sync — playback volume on iPhone now follows the system output
• High-fidelity mixer — fixed mixer conflicts and metadata reads in high-fidelity audio graph mode
• Tab bar — the tab bar no longer disappears when nothing is playing
• Placeholder scraper endpoints — scraper endpoints with no real content are skipped, cutting down pointless requests
• Search index — cancelling indexing normally no longer reports an error

This release consolidates changes made after 1.7.0 that had not yet been documented, with a focus on very large libraries, real multi-source deletion, Apple Music, Baidu Netdisk, search playback, CarPlay, and cross-device sync.

Added

• Real deletion across music sources — duplicate cleanup can call each source's deletion capability instead of only removing local records, with batching, progress recovery, and retry support
• Mixed-source playback queues — one queue can continuously play local, NAS, cloud-drive, Subsonic, and media-server tracks
• Persistent search index — indexes titles, artists, albums, Pinyin, and lyrics for faster large-library search and lyric hits
• Airsonic compatibility mode — handles the Subsonic API differences in both classic and Advanced releases across scanning, artwork, lyrics, and Range playback
• Remote notification support — adds the app-level registration and handling foundation for remote notifications
• CarPlay search entry — adds an always-visible Search row to songs, albums, artists, playlists, and recent items, with recent phone search terms and matching results available in-car

Changed

• Apple Music library sync — rebuilt synchronization, identity mapping, and play-history association to reduce duplicates and stay aligned with the system library
• Apple Music lyric scraping — service-owned work now continues after the player collapses and stores lyrics against the canonical song identity
• Source scanning — added directory-selection sessions, batched scan mutations and checkpoints, and improved FTP continuity and remote metadata parsing
• Source counts — source cards are reconciled against the device's actual library instead of displaying stale cloud snapshots or historical scan totals
• iCloud lyric snapshots — oversized inline payloads progressively shrink to the newest subset that fits instead of dropping the whole lyric snapshot
• App icons and cloud sync — refreshed the icon system and reduced unnecessary synchronization and view updates

Fixed

• Baidu smart duplicate cleanup — validates every per-file batch result so partial failures are not reported as success or written as false local deletions
• Baidu large-directory scans — retries transient read failures and rate limits with backoff instead of abandoning the selected directory
• Search-result playback crash — keeps the tab and bottom-player view structure stable while the system search controller is dismissed
• CloudKit and SMB crashes — disables sync safely when CloudKit entitlements are unavailable and serializes SMB session lifecycles to prevent scrape-write/disconnect races
• Batch-scrape accuracy — uses stable remote identity seeds and confidence-based matching, keeps duplicate copies consistent, rejects overlapping batches, and stops repeated writes to read-only or unauthorized sources
• Large-library stalls — fixed cold-launch, song-list refresh, background scraping, and bulk-cleanup paths that could freeze the UI or trigger the scene watchdog
• Duplicate cleanup — fixed stale results, interrupted batches that could not resume, and missing real deletion for Baidu sources
• Local-file recovery — safely rebases old sandbox paths into the current container and stops custom local sources from being redirected to the managed import folder
• Local playback caching — local files no longer enter the remote offline-cache pipeline, preventing duplicate storage and misleading warnings
• MV pause behavior — pausing video also cancels the full-file background download while retaining its partial file for later use
• Scraping and translation logs — empty titles no longer query online providers, and lyrics already in the target language no longer create no-op translation failures
• Simulator credentials — uses local Keychain items when synchronizable Keychain attributes are unavailable, preserving credentials across app restarts
• Audio session startup — cold launch no longer interrupts audio already playing in another app
• Local source platform labels — adding a local source on macOS no longer shows “iPhone Storage” or an iPhone icon; it now uses “Mac Storage” and a computer icon, and tvOS uses Apple TV chrome if a local source is present
• Malformed media and playback menus — hardened invalid inputs, Now Playing menu updates, and lyric-scrolling edge cases

Performance

• Library lookup — replaces repeated full scans with caching and a persistent search index, reducing CPU while typing in very large libraries
• Scanning and cleanup — batches song mutations and lowers checkpoint and UI publication frequency instead of persisting once per track
• Foreground batch work — requests the finite iOS background-execution window only after the app actually backgrounds, eliminating long foreground-scrape warnings
• Lyrics and Now Playing — reduces view recomputation from lyric scrolling and playback progress while keeping menus stable during high-frequency updates

This release adds mixed-source queues, real deletion across music sources, and a persistent search index, while improving large-library startup, list refreshes, and background batch work.

Added

• Mixed-source queues — local, NAS, cloud-drive, Subsonic, and media-server tracks can play continuously in one queue
• Real cross-source deletion — duplicate cleanup deletes original files according to source capabilities, with batching, recovery, and retry support
• Persistent search index — indexes titles, artists, albums, Pinyin, and lyrics for faster large-library lookup
• Remote notification foundation — adds app registration and message-handling support for remote notifications

Changed

• App icons and cloud sync — refreshed the icon system and reduced unnecessary synchronization and view updates
• Large-library work — song-list refreshes, bulk cleanup, and background scraping now process changes in batches to reduce foreground stalls

Fixed

• Baidu Netdisk cleanup — validates each batch deletion result and retries transient failures instead of reporting partial failures as success
• Malformed media and playback menus — hardened damaged inputs and Now Playing menu state updates
• Audio session startup — cold launch no longer interrupts audio already playing in another app

This release reorganizes music-source management and folder selection, focusing on lower scanning-write and interface-refresh overhead.

Changed

• Music source management — optimized source-state handling and remote metadata parsing, with folder selection moved into a dedicated session before scanning starts
• Batched scanning — groups song mutations, checkpoint writes, and interface publication instead of persisting every item independently

Fixed

• FTP scan continuity — transient read failures no longer abandon the entire folder scan, and remaining items continue after recovery

This release starts at commit 4a8937f9 and focuses on large-library performance, the Home and Library experience, and cross-platform polish for iPhone, Mac, and Apple TV.

Added

• Customizable Home sections — show, hide, and reorder Continue Listening, Quick Favorites, For You, My Playlists, Top Artists, Recently Added, and listening statistics
• Quick Favorites and search — pin albums, artists, or playlists; search while editing; and keep selected items together for faster removal
• First-install feature tour — introduces cloud drives, NAS, Apple Music, metadata scraping, cross-device playback, app icons, and Home customization
• Complete release notes — update prompts can expand and collapse long notes
• GitHub feedback links — open the repository or Issues from About for faster reporting and follow-up

Changed

• NAS support status — UGREEN UGOS and Feiniu fnOS now show as unavailable while awaiting vendor-supported public APIs and can’t enter the new-source setup flow
• 123 Cloud Drive OAuth callback — replaced the HTTPS relay with the registered app deep link and added strict scheme, host, path, and state validation
• Home and Library layout — introduced clearer card hierarchies and redesigned Quick Favorites plus the Songs, Albums, Artists, and Playlists entry points
• Music video playback — videos are larger in portrait, automatically enter landscape fullscreen on iPhone, and restore the previous orientation on exit
• Apple Music playlist visibility — read-only mirror playlists are hidden while Apple Music sync or its source is disabled and return when re-enabled
• macOS and tvOS adaptation — improved localization, branding, Mac settings, Apple TV navigation, and remote playback controls

Fixed

• Song titles — scanning and metadata backfill now prefer embedded titles instead of always showing filenames
• Spotlight stability — artwork thumbnails now use ImageIO off the main thread, fixing a UIKit rendering crash and reducing peak memory use
• tvOS navigation and playback controls — fixed filter focus, returning to the tab bar, global play/pause, and remote-command main-thread handling

Performance

• Scanning and tag reading — batch library mutations, publish progress and checkpoints less often, and move large JSON encoding off the main thread
• Home and source list — cache Home snapshots, artwork tints, source-song groups, and remaining-backfill counts to avoid repeated work while scrolling
• Large-library indexing — batch artwork invalidations and checkpoint writes to reduce main-thread overhead during continuous 10K-track scans

Added

• Added guest connections without an account and stronger port validation for SMB, S3, WebDAV, and other sources
• Added independent music-video formats with parsed and persisted MV duration
• Added server base paths, server-side metadata refresh, and scraped metadata write-back for Jellyfin, Emby, and Plex
• Added four app-icon themes

Changed

• Improved scraper imports and cloud-storage connection flows
• Improved Chinese title repair and media-server scan matching

Fixed

• Fixed Jellyfin and Emby authentication, scanning, and direct audio playback
• Fixed default ports after SSL changes, trusted-device token synchronization, and other connection issues

Added

• Music sources without a direct playback URL can now stream MVs through progressive download
• MV streaming now supports on-demand caching, range requests, and playback fallback

Fixed

• Fixed MV fullscreen state, cache cleanup, audio fallback, and cache-write race conditions
• Unified the macOS app product name to avoid duplicate names during builds and installation

Added

• Added whole-folder local imports with duplicate-import and post-reinstall recovery handling
• Added third-party OAuth for 123 Cloud Drive with cover and lyrics write-back
• Added MV sidecar discovery, a dedicated playback mode, fullscreen controls, and local caching
• Added playlist shuffle and refined experimental UGREEN NAS API scaffolding (not a supported integration)

Changed

• Reworked source soft deletion, cache cleanup, and failed metadata-backfill retries
• Hardened cloud error-response detection, local scanning, token refresh, and cross-device deletion sync

Fixed

• Fixed CarPlay crashes and stalls, audio-route crashes, and tab-limit crashes
• Fixed resume scans clearing playlists, incorrect scrobbles, previous-track crashes in shuffle, and crossfade deadlocks
• Fixed Plex/Subsonic scan interruptions, Synology metadata loss after rescans, Baidu token encoding, and cache filename collisions
• Fixed deleted sources being recreated by older cross-device snapshots

Added

• Completed Apple TV source management, direct playback, on-device metadata scanning, search, lyrics, and localized UI
• Added scraped cover and lyrics write-back for OneDrive, Dropbox, Google Drive, Baidu Netdisk, and Aliyun Drive
• Added whole-source offline caching, custom equalizer presets, and a cellular-backfill prompt
• Added Traditional Chinese and completed German, French, Japanese, and Korean localization

Changed

• Moved every platform and extension to one shared version source
• Added local credential entry, connection tests, whole-library playback, live progress, and fuller Siri Remote interaction on Apple TV
• Reworked word-level lyrics scrolling, line transitions, and highlighting

Fixed

• Fixed OneDrive large-file interruptions, HTTP/3 throttling, and playback failures caused by extensionless cache files
• Fixed Apple TV library snapshot download, decompression, persistence, credential sync, and foreground timing
• Hardened TLS certificate pinning, SFTP host-key validation, log redaction, and OAuth-source deduplication
• Fixed crossfade truncation, decoder loops, sparse-cache loss, and Follow System Output failures
• Fixed issues across Widgets, Live Activities, Watch, tvOS, CarPlay, and large lists

Added

• Formally added the Apple TV app with the real library, artwork, queue, search, and source management
• Added Apple TV playback for Synology, S3, Navidrome/Subsonic, Jellyfin, Emby, Plex, major cloud drives, and iPhone-relayed sources
• Added Push to Apple TV, local-network relay, and QR-based source setup
• Added Top Shelf, a full-bleed parallax icon, and Universal Purchase configuration
• Added Navidrome/Subsonic, 115 Cloud, and 123 Cloud Drive sources

Changed

• Library snapshots, sources, and encrypted credentials now sync between iPhone, Mac, and Apple TV through iCloud
• Disabled sources no longer contribute songs to Library, statistics, or playback results

Fixed

• Fixed Apple TV focus clipping, empty states, system-keyboard search, format detection, and self-signed NAS playback
• Replaced unreliable tvOS CKAsset snapshot downloads

1.5.0 began as a development anchor, then had its build aligned again during the macOS and tvOS merges.

Added

• Added a full DLNA Controller with device discovery, casting, and background session retention
• Added the complete iCloud Family Sharing flow with invitations, acceptance, and shared-database routing
• Redesigned the Library landing page with playlist artwork, playlist reordering, and a pinned Liked Songs entry
• Redesigned the native macOS experience with themes, brand colors, app icons, desktop widgets, and dedicated player surfaces

Changed

• Brought Apple Music, DLNA casting, Family Sharing, and playback shortcuts to macOS
• Indexed playlist and recent-play queries to avoid repeated large-library scans

Fixed

• Fixed partial-cache gapless loading loops and tracks advancing before playback ended
• Fixed duplicate scanning stalls, lost cleanup progress, and playlist hangs
• Fixed macOS CloudKit launch loops, desktop-widget loading, and Spatial Audio permission issues

Added

• Fully integrated Apple Music with library browsing, subscription playback, a dedicated Now Playing experience, and the system Liked Songs playlist
• Made artist-page songs directly playable and changed album grids to adaptive columns

Changed

• Rebuilt DLNA SSDP discovery for more reliable local-device detection

Fixed

• Prevented invalid playback attempts when Apple Music subscription access is unavailable

Added

• Added playback speed, Hi-Res quality badges, and Spatial Audio
• Added pinyin and lyrics search with matching snippets
• Added Last.fm similar tracks, song radio, and discovery recommendations
• Added offline audio downloads, persistent ReplayGain tags, and guarded gapless playback
• Added grouped smart-playlist rules

Fixed

• Fixed legacy Chinese metadata encoding, delayed scraped artwork refresh, and main-thread lyrics search
• Improved DLNA/UPnP compatibility, mute-volume state, and gapless/crossfade race handling

Added

• Added Siri Shortcuts, Watch complications, Lock Screen widgets, and Control Center widgets
• Added Dynamic Island actions, Spotlight search, iPad landscape Now Playing, and external-display playback
• Added the tag editor, first-launch onboarding, VoiceOver, and wide iPad layouts
• Added cross-device Handoff with full queue context
• Added Apple Music search and a DLNA MediaRenderer receiver mode
• Added spectrum visualization, DLNA volume sync, event subscriptions, and protocol diagnostics
• Added Japanese, Korean, German, and French localization

Fixed

• Moved FFT processing off the real-time audio thread
• Fixed remote-stream duration probing, media-server direct playback, LRCLIB casts, and OAuth refresh encoding
• Hardened QNAP, S3, Last.fm, and DLNA protocol handling and refined experimental UGREEN NAS API scaffolding

Added

• Added the Apple Watch companion app with library browsing and Now Playing controls
• Added smart playlists, the annual listening report, and a listening-stats Home summary
• Added For You, Top Artists, Today's Pick, and Home-section visibility controls
• Added App Store update prompts, manual update checks, and reusable illustrated empty states

Performance

• Reduced main-thread stalls during large-library scans, metadata backfill, and batch deletion
• Accelerated Baidu Netdisk tag reading with background continuation and completion notifications

Fixed

• Fixed stale scraped artwork, player deadlocks, queue reordering overlap, and deleted-source sync

Added

• Added range streaming across NAS, SMB, SFTP, FTP, NFS, and cloud drives
• Added metadata backfill, multi-candidate lyrics caching, and offline lyrics translation
• Added Last.fm / ListenBrainz scrobbling, listening statistics, and duplicate detection
• Added M3U8 / Primuse JSON playlist import and export plus a CarPlay Playlists tab
• Added word-level lyrics sweep, smooth line transitions, and explicit manual-scrape overwrite behavior

Changed

• Moved caches to on-demand growth under LRU management, with separate prewarm, active-download, and physical-size reporting

Fixed

• Switched Last.fm to the desktop auth flow to fix 403 responses
• Fixed sparse caches, partial-cache finalization, lyrics-cache downgrades, and the blank state after a single track ended

Added

• Added the CloudKit foundation for synchronizing sources, playlists, and library state
• Added album and artist details plus cached artwork components

Fixed

• Fixed cached CloudKit system fields to avoid conflicts while updating existing records
• Fixed OAuth callback and sync-model compatibility

Added

• Added Baidu Netdisk, Dropbox, Aliyun Drive, WebDAV, and FTP sources
• Added importable custom scraper configurations and management UI
• Added app-icon switching, lyrics font sizing, and cloud-token management
• Improved Home Screen widgets and their cloud Now Playing state

Changed

• Refactored playback services and dependency injection for cloud playback and queue management

Added

• Added a reusable cloud-drive OAuth authorization and token-refresh flow
• Added built-in cloud credential configuration and cloud connection UI
• Redesigned Now Playing and Quick Access widgets

Fixed

• Improved cloud credential loading and playback-state synchronization

Added

• Added equalizer and audio-effects settings

Changed

• Refactored SSL trust management and removed hard-coded domain configuration
• Completed project entitlements, signing, and build configuration

The first iPhone and iPad release.

Added

• A multi-source library for local files, Synology, SMB, SFTP, NFS, S3, WebDAV, and media servers
• An SFBAudioEngine-based playback engine, queue, and album/artist browsing
• Regular playlists, metadata scraping, and artwork/lyrics caching
• Home with recently played tracks and album recommendations
• CarPlay, remote controls, network discovery, and basic localization

A stability and experience update after the initial macOS 1.0.0 release, bringing over important iOS fixes and polishing Mac-specific windows and layout.

Added

• Source authentication feedback — background connection failures now show an error and let users re-enter credentials
• Negative cache for failed lyrics translation — deterministic unsupported-language errors are cached for 24 hours instead of retried on every playback
• Content-addressed artwork storage — MetadataAssets/content/<sha>.jpg lets tracks from the same album share one physical JPEG
• Automatic content eviction — background garbage collection removes orphaned content and evicts oldest files beyond 500 MB
• Desktop lyrics and menu-bar controls — continued refinement of the macOS-specific playback surfaces introduced in 1.0

Changed

• Library tools moved out of Settings — rescan, re-scrape, and cache controls now live with the Library
• Scrape sheets default to full height — automatic and manual scrape actions no longer appear missing below a medium sheet
• Native scraping window — macOS scraping now opens in an NSWindow with standard traffic-light controls

Fixed

• Apply changes stall and crash — closes the scraping window first, then applies library and sidecar changes in a background task
• Synology login storms and DSM blocking — concurrent requests for one source now share a single in-flight login
• SFTP `try!` crash risk — authentication is resolved before capture instead of force-throwing inside a callback
• Lost partial translations — completed responses are retained when a later translation batch throws
• Legacy local-reference precedence — corrected an unused but invalid && / || expression
• Broken word-level lyrics rendering — fixed discontinuous masks on macOS
• Lyrics not refreshing after scraping — successful scraping now reloads the active lyrics view

Performance

• Artwork storage reduced by about 98% — typical same-album artwork drops from many duplicate JPEGs to one shared file plus tiny redirect records
• Single Synology login — concurrent playback and prefetch requests reuse one authentication task
• Removed duplicate post-scrape refreshes — the shared song-replacement notification is now the only refresh path

The first standalone macOS release.

Added

• Cross-platform playback, scraping, sidecar write-back, and library management
• Floating desktop lyrics
• Menu-bar playback controls
• A three-column Mac interface with a sidebar, detail area, and bottom player
• A floating mini player
• Fullscreen macOS Now Playing
• OAuth callbacks through the primuse:// URL scheme