SPlayer version history

- Fixed native module architecture mismatch causing load failures. - Rewrote release process using gh CLI and merged multi-architecture update lists. - Resolved delayed loading state overriding desktop lyrics. - Project now in maintenance mode; new features will be developed in SPlayer-Next.

## 本项目进入维护模式 > 项目已进入维护模式，后续仅进行必要的维护与重大问题修复，不再主动开发新功能 > 新功能及后续版本请移步 [SPlayer-Next](https://github.com/SPlayer-Dev/SPlayer-Next) ## What's Changed * docs(README): Add "Ask DeepWiki" badge and links for others by @bywhite0 in https://github.com/SPlayer-Dev/SPlayer/pull/896 * 修复因为开启私人漫游导致无法打开分享链接 by @kazukokawagawa in https://github.com/SPlayer-Dev/SPlayer/pull/898 * 尝试支持类似Apple Music的AutoMix[Beta] by @kazukokawagawa in https://github.com/SPlayer-Dev/SPlayer/pull/888 * chore: 将 @electron/node-gyp 依赖从 git 协议更改为 https tarball by @kazukokawagawa in https://github.com/SPlayer-Dev/SPlayer/pull/899 * Dev cy 02 by @kazukokawagawa in https://github.com/SPlayer-Dev/SPlayer/pull/901 * fix(package): 删除依赖项中的 tools 原生模块包 by @MoYingJi in https://github.com/SPlayer-Dev/SPlayer/pull/900 * [ #904 ] - feat: 新增分享链接格式设置及统一生成函数 by @kazukokawagawa in https://github.com/SPlayer-Dev/SPlayer/pull/907 * fix(lyrics): 修复AM歌词页跳转行位置的问题 by @laoshuikaixue in https://github.com/SPlayer-Dev/SPlayer/pull/893 * refactor(DownloadPage): 重构了部分识别与判断逻辑 by @MoYingJi in https://github.com/SPlayer-Dev/SPlayer/pull/906 * 🐞 fix: 修复播放速率被误禁用，切换播放引擎时跨设备id的不兼容，seek后没有立刻发出 Seeked D-Bus 信号 by @lrst6963 in https://githu

## What's Changed * 🌈 style(setting): 修复 set-item 中 beta tag 位置异常 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/785 * Dev cy by @kazukokawagawa in https://github.com/imsyy/SPlayer/pull/789 * ✨ feat: 支持AB循环 by @kazukokawagawa in https://github.com/imsyy/SPlayer/pull/794 * feat: 允许在网页端显示realIP设置 by @MoeFurina in https://github.com/imsyy/SPlayer/pull/791 * ✨ feat: 支持切源播放 by @kazukokawagawa in https://github.com/imsyy/SPlayer/pull/795 * ✨ feat: 实现基础的任务栏歌词 by @apoint123 in https://github.com/imsyy/SPlayer/pull/777 * 🐞 fix: 修复锁文件 by @apoint123 in https://github.com/imsyy/SPlayer/pull/797 * feat: 避免含有标题的较短本地音乐因时长或文件大小而被排除 by @kyv001 in https://github.com/imsyy/SPlayer/pull/796 * refactor(setting): 优化设置 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/800 * 🐞 fix: 修复客户端上 **开发人员** 与 **更多贡献者** 头像无法正确显示的问题 by @ITManCHINA in https://github.com/imsyy/SPlayer/pull/799 * 🦄 refactor: 重写本地扫描逻辑 大幅度优化扫描效率 by @kazukokawagawa in https://github.com/imsyy/SPlayer/pull/793 * 🐞 fix: 修复as any类型问题 by @kazukokawagawa in https://github.com/imsyy/SPlayer/pull/802 * 🐛fix(desktop-lyrics): 修复桌面歌词加载时的占位符闪烁问题 by @Pissofdvpe in https://github.com/imsyy/SPlayer/pull/781 * ✨ feat: 支持

## ✨ 新增功能 - 新增流媒体，支持 Jellyfin / Navidrome / Emby 等 - 设置页面 UI 优化，支持搜索 / 快捷跳转 - 新增支持自定义图片背景，优化主题配置 - 新增全屏播放样式 - 新增单曲 Wiki 页面，可查看歌曲详情及乐谱等信息 - 新增多账号切换 - 主要界面适配移动端显示 - 新增 FFmpeg 及 MPV 播放引擎以支持更多音频格式（#716） - 本地歌词新增支持解析 逐字 LRC 与 增强型 LRC - 缓存采用 SQLite 实现 - 播放器菜单新增音质切换 - 新增本地及在线歌曲优先使用 QM 歌词 - 支持暂停播放时同步暂停背景动画（#706） - 优化并增强音频元数据清理逻辑（#697） - 新增播放或下载歌曲时将歌词展示为多种繁体格式 - 部分完善本地模式 - 新增封面 / 歌词占比调节，歌词滚动位置无极调节 ## 🛠 修复与优化 - 修复网页端无法正常登录（#722） - 修复定时关闭失效 - 限制 Linux 下 MPRIS 状态更新频率，防止状态抖动（#704） - 修复本地播放模式下的播放逻辑问题（#701） - 优化歌曲播放时间显示格式相关代码（#700） - 重写时间相关核心逻辑（#715） - 修复歌词排除逻辑中未正确处理 TTML 的问题（#708） - 修复 TTML 歌词多语言翻译异常（#719） - 修复无边框窗口模式在重启后自动开启的问题（#717） - 更新并完善项目文档内容（#693 #698） ## What's Changed * docs: 文档更新 by @RainyGrass in https://github.com/imsyy/SPlayer/pull/693 * fix:限制Linux下MPRIS状态更新的频率，以防止出现抽搐bug。 by @lrst6963 in https://github.com/imsyy/SPlayer/pull/704 * fix: :bug: 修复本地播放模式逻辑 by @awsl1414 in https://github.com/imsyy/SPlayer/pull/701 * docs: 更新文档 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/698 * perf: 优化歌曲播放时间显示格式相关代码 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/700 * ✨ feat: 更好的元数据清理 by @apoint123 in https://github.com/imsyy/SPlayer/pull/697

# 🎉 2026 年新年快乐！ ## ✨ 新增功能 - 💻 改进 Windows 媒体控件集成，支持高清封面和更多的控制功能 - 📝 新增 Last.fm 支持 - 💾 新增歌曲本地缓存功能 - 📂 新增播放列表缓存功能 - 🎧 支持播放过程中切换音质，需开启歌曲信息展示 - 🧩 新增 Discord RPC，可展示当前播放状态 - ⏱ 点击当前播放时间可在正计时 / 倒计时之间切换 - 🖊 歌曲评论文本支持鼠标拖拽选择 - ⏲ 新增播放时间显示格式切换功能 ## 🛠 修复与优化 - ▶️ 修复启动时无法正常播放 #639 #630 #635 - ▶️ 修复选中歌曲播放按钮无法切歌 #655 #683 - 🧑‍🎤 修复歌手信息更新失败及歌手头像丢失的问题 - 🖥 修复点击桌面歌词按钮时报错的问题，并支持跳转到桌面歌词设置 - 🎬 修复「为我推荐」页面点击 MV 时错误显示评论区的问题 - 📄 修复未正确解析带翻译 LRC 歌词结束时间的问题 - 📥 修复下载相关问题及音质切换异常 - 🧾 修复缓存大小上限默认值处理不正确的问题 - 📜 修复本地列表过长导致的显示问题 - 💻 修复主窗口在桌面歌词区域移动或调整大小时出现的闪烁问题 - 🧩 修复开发人员卡片宽度显示异常 - 🌐 修复官网部分显示问题 - 🎤 完善歌词字体自定义相关功能 - 🌈 优化 AMLL 歌词高亮显示效果 - 🔁 优化歌单在单曲循环模式下的自动切换逻辑 - 🎚 优化下拉筛选交互方式 - ⚡ 修复开启「自定义 CSS 字体」后修改全局字体时出现的卡顿问题 - 🎨 优化本地目录列表样式 - 🎨 优化歌词设置页中歌词预览的显示样式 - 🎨 优化歌词滚动至顶部附近时的显示效果 ## 🦄 重构调整 - 🧱 拆分播放模式按钮为两个独立按钮 - 🔤 调整歌词字体配置的管理方式 ## 📚 其他 - 📝 更新项目文档 ## What's Changed * fix：修复歌手信息跳转更新失败和歌手头像丢失问题 by @flystar233 in https://github.com/imsyy/SPlayer/pull/632 * 🎈 perf: 完善歌词字体自定义 by @kazukokawagawa in https://github.com/imsyy/SPlayer/pull/634 * ✨ feat: 新增本地缓存功能 by @imsyy in https://github.com/imsyy/SPlayer/pull/640 * fix &feat 修复打开桌面歌词按钮报错bug,和增加点击桌面歌词设置按钮后直

## ✨ 新增功能 - ⚙️ 设置项迁移（AMLL TTML DB）：在设置中新增 AMLL TTML DB 相关说明与配置 - ⏬ 下载重试按钮：新增下载失败后的重试入口，解决进度卡在 0% 的问题 - 💬 新增列表评论：歌曲及专辑列表支持评论展示与交互 - 🧹 完善歌词排除列表：支持一键清空歌词排除列表 - 🔁 播放器逻辑重构：对播放器核心逻辑进行重构，提升整体可维护性与扩展性 ## 🛠 修复与优化 - 🔍 搜索框分享地址识别完善，支持移动端分享链接 - 🔗 更新弹窗链接行为：修复更新对话框中的超链接在 Electron 窗口内打开的问题 - ⭐ 收藏数量限制修复：解决收藏数据被错误限制为 200 条的问题 - ⌨️ macOS 快捷键异常：修复在 macOS 下使用快捷键退出应用异常的问题 - 🪟 模态框组件整理：调整模态框组件的导入路径，优化项目结构与可读性 ## 📢 广告位招租（ 感谢 AMLL 对本项目的大力支持 ❤️ 快去点上小心心 👉 https://github.com/Steve-xmh/applemusic-like-lyrics ## What's Changed * ✨ feat: 增加下载重试按钮，解决卡0%问题 by @kazukokawagawa in https://github.com/imsyy/SPlayer/pull/614 * 🐞fix: 修复错误的类型 by @apoint123 in https://github.com/imsyy/SPlayer/pull/613 * :bug: fix: update dialog hyperlinks opening in Electron window by @uarix in https://github.com/imsyy/SPlayer/pull/616 * 🐞 fix: 修复收藏数据200限制 by @SUBearH in https://github.com/imsyy/SPlayer/pull/618 * ✨ feat: 列表添加评论 by @imsyy in https://github.com/imsyy/SPlayer/pull/621 * feat(settings): 关于 AMLL TTML DB by @MoYingJi in https://github.com/imsyy/SPlayer/pull/622 * 🐞 fix: 修复Mac使用快捷键退出异常 by @Beriholic in https://github.com/imsyy/SPlayer/pull/623 * refactor(modal): 调整模态框组件导入路径 by @MoYin

## 🚨 重大变更 - 🧩 播放内核替换：移除 Howler.js，切换为原生 Audio / AudioContext 实现 ## ✨ 新增功能 - 🎵 新增播放器流体背景 - 🎨 支持自定义侧边栏与首页内容 - 🎤 本地 LRC 音译解析，支持显示带音译的本地歌词 - 📄 支持嵌入歌词的翻译与音译 - 🔗 为每个页面加入分享链接按钮，分享更方便 - 📝 桌面歌词窗口新增标题显示 - ⚙️ 可在设置中选择是否注册自定义协议，部分系统支持通过 Orpheus 协议唤起 SPlayer - 📅 歌单页面新增创建时间显示 ## 🛠 修复与优化 - 📝 桌面歌词窗口新增标题显示，优化逐字效果 - ⚙️ 优化部分性能问题 - 🎵 修复歌词点击跳转未正确应用偏移的问题 - 📝 修复本地歌词文件名带前缀时无法匹配的问题 - 📃 修复歌单描述中换行未正确展示的问题 - ▶️ 修复极端情况下的播放异常 - 💼 规范 Linux Desktop 文件格式 - 🔍 FastGlob 匹配现在大小写不敏感 - 🖼 UI 进一步优化 ## What's Changed * feat(lyric): 支持解析本地 LRC 歌词中的音译 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/559 * fix(Lyric): 点击歌词跳转进度未应用偏移 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/563 * docs: 更新 Issue Template by @MoYingJi in https://github.com/imsyy/SPlayer/pull/566 * fix(player): 修复极端状态下播放异常 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/567 * docs: 小改 Issue Template by @MoYingJi in https://github.com/imsyy/SPlayer/pull/573 * fix(local-lyric): 现在会匹配带前缀的歌词文件名 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/578 * fix(playlist): 歌单描述有换行时并没有正确换行 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/583 * Increase max badge value from 999 to 9999 by @

# ⚠️ 提醒 这是 Beta.4 的修复版本，如果你是从 Beta.3 升级，该更新将会清除现有全部配置，请酌情更新 ## 🛠 修复与优化 - 优化桌面歌词 hover 效果，避免长时间不消失 - 修复窗口关闭问题 #547 #552 #546 ## What's Changed * fix(ttml): 行结束时间过早 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/548 * refactor(unlock): 重写部分 getUnlockSongUrl by @MoYingJi in https://github.com/imsyy/SPlayer/pull/549 * refactor(LyricsSetting): 增加歌词内容分组 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/550 * feat(LocalLyric): 使本地覆盖在线歌词的文件更好管理 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/554 * fix(lyric): 关闭在线 TTML 歌词后不获取本地 TTML 歌词了 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/556 **Full Changelog**: https://github.com/imsyy/SPlayer/compare/v3.0.0-beta.4...v3.0.0-beta.5 ## What's Changed * fix(ttml): 行结束时间过早 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/548 * refactor(unlock): 重写部分 getUnlockSongUrl by @MoYingJi in https://github.com/imsyy/SPlayer/pull/549 * refactor(LyricsSetting): 增加歌词内容分组 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/550 * feat(LocalLyric): 使本地覆盖在线歌词的文件更好管理 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/554 * fix(lyric): 关闭在线 TTML 歌词后不获取本地 TTML 歌词了 by @MoYingJi in https://github.com/imsyy/SPlayer/p

# ⚠️ 提醒 该更新将会清除现有全部配置，请酌情更新 ## ✨ 新增功能 - 🎵 桌面歌词全新升级，支持 **双行、逐字、字体** 及 **跨屏拖动** - 🧩 全面优化 TTML 歌词的展示及本地支持 - 🔊 新增 **自动结束** & **均衡器** （Beta 测试，目前很不好用 😅） - 💡 新增 **每日推荐 - 不感兴趣** 功能 - 📄 新增 **本地歌词可覆盖线上** - 🎧 更新 **解灰音源**，下线原 Kuwo ## 🛠 修复与优化 - ⚙️ 优化播放器界面的各项功能切换效果 - 💿 修复 **专辑无法收藏** 的问题 - 🧠 优化歌词排除配置，支持 **正则表达式** - ⏩ 修复 **进度条点击时无法调节进度** - 🪟 修复 **偶发窗口状态与控制按钮不同步** 的问题 ## What's Changed * fix: AM 歌词翻译错位 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/494 * feat: 记忆窗口最大化状态 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/495 * 修复 UnblockNeteaseMusic 返回非 https 协议链接时反代失败的问题 by @xiaoQQya in https://github.com/imsyy/SPlayer/pull/496 * 修改默认 unblock source 为 kugou bodian pyncmd by @xiaoQQya in https://github.com/imsyy/SPlayer/pull/497 * fix: dev.mjs linux/mac 无法启动开发环境 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/500 * fix: 恢复窗口最大化状态时过早显示窗口 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/501 * feat: 对本地歌词的修改 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/502 * fix: 更改函数名后构建失败 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/503 * feat: 优化启用 TTML 选项的逻辑 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/507 * feat(lyric): 优化歌词

## What's Changed * fix:修复歌词显示相关 by @Pissofdvpe in https://github.com/imsyy/SPlayer/pull/469 * fix: 修复 macos 和linux 本地歌曲路径问题 by @serious-snow in https://github.com/imsyy/SPlayer/pull/452 * fix(getOnlineUrl): 修复网页端登录后获取url的CORS问题 by @MoeFurina in https://github.com/imsyy/SPlayer/pull/472 * ✨feat(LyricWithTTMLFormat): 支持从steveXMH仓库获取TTML歌词 by @MoeFurina in https://github.com/imsyy/SPlayer/pull/481 * fix: adjust minimum window size 调整最小窗口大小 by @q1zhen in https://github.com/imsyy/SPlayer/pull/479 * feat: 支持为日语单独设置字体 by @MoYingJi in https://github.com/imsyy/SPlayer/pull/484 * 🔧 build: 优化 CI/CD 构建流程，增加多架构支持 by @awsl1414 in https://github.com/imsyy/SPlayer/pull/491 ## New Contributors * @Pissofdvpe made their first contribution in https://github.com/imsyy/SPlayer/pull/469 * @MoeFurina made their first contribution in https://github.com/imsyy/SPlayer/pull/472 * @q1zhen made their first contribution in https://github.com/imsyy/SPlayer/pull/479 * @MoYingJi made their first contribution in https://github.com/imsyy/SPlayer/pull/484 * @awsl1414 made their first contribution in https://github.com/imsyy/SPlayer/pull/491 **Full Changelog**: https://github.com/imsyy/SPlayer/compa