starred/SPlayer
1
0
Fork 0
mirror of https://github.com/imsyy/SPlayer.git synced 2026-04-25 06:55:57 +03:00
Code Issues 30 Projects Releases 10 Packages Wiki Activity

[GH-ISSUE #595] Linux Wayland 有关问题 #310

New issue
Open
opened 2026-02-27 07:11:12 +03:00 by kerem · 4 comments
kerem commented 2026-02-27 07:11:12 +03:00
Owner
Copy link

Originally created by @MoYingJi on GitHub (Nov 28, 2025).
Original GitHub issue: https://github.com/imsyy/SPlayer/issues/595

切换回 Xwayland

从某个版本以后，SPlayer 会默认以原生 Wayland 模式运行，这样会导致一些兼容性问题
如果有必要，在这些问题解决之前，推荐切换回 Xwayland 模式使用

你可以在启动时添加 --ozone-platform=x11 的 Electron 参数来指定以 Xwayland 模式运行 SPlayer
（开发环境可以使用 pnpm dev -- --ozone-platform=x11 启动）

你也可以直接修改桌面项，而不用每次都手动添加参数运行

KDE Plasma Wayland

KDE 应该自带了菜单编辑器，你可以

  1. 右击 SPlayer 的桌面项
  2. 点击 编辑应用程序...
  3. 在右侧的 命令行参数 中将 %U 更改为 --ozone-platform=x11 %U
  4. 保存并退出
其他 DE/WM

大致原理差不多，你可以

  1. 找到 SPlayer 的桌面项位置（应该在 /usr/share/applications/SPlayer.desktop）
  2. 复制此文件到 ~/.local/share/applications/SPlayer.desktop
  3. 使用任意文本编辑器打开
  4. 找到以 Exec= 开头的行，替换为 Exec=/opt/SPlayer/SPlayer --ozone-platform=x11 %U
  5. 保存并退出

Wayland 桌面歌词

这个方案是有瑕疵的，我们为桌面歌词窗口设置了专门的窗口标题（SPlayer - 桌面歌词）以方便窗口规则匹配
对于 KWin 窗口规则，可参考 这条评论

第三方代替

如果只是需要桌面歌词等，你可以使用兼容的第三方项目

可以使用由 lrst6963 贡献的 桌面歌词 (Splayer-kde-lyc) 和 KDE 任务栏歌词组件 (Splayer-kde-bar-lyc)
这两个项目都通过 WebSocket 与 SPlayer 连接，可以获取到准确的歌词
btw，本项目名称为 SPlayer，强迫症.jpg

也可以使用由 KangweiZhu 维护、Neokoni 贡献了 SPlayer Mode 的 lyrics-on-panel
项目通过 SPlayer 暴露的 API 使用 HTTP GET /api/control/song-info 获取当前播放的歌曲与歌词

知名的 Waylyrics 当然也能用，不过此项目只能通过 MPRIS 获取歌曲信息，再搜索歌词，所以有时候的歌词不一致，也当然无法应用 SPlayer 的歌词排除设置

结尾

对于影响所有 Linux Wayland 有关的，你可以在这下面讨论；对于仅影响单个问题的进展，可以继续在那个 Sub-issue 里追踪；遇到了新的问题也可以开新的 Issue

Originally created by @MoYingJi on GitHub (Nov 28, 2025). Original GitHub issue: https://github.com/imsyy/SPlayer/issues/595 ## 切换回 Xwayland 从某个版本以后，SPlayer 会默认以原生 Wayland 模式运行，这样会导致一些兼容性问题 如果有必要，在这些问题解决之前，推荐切换回 Xwayland 模式使用 你可以在启动时添加 `--ozone-platform=x11` 的 Electron 参数来指定以 Xwayland 模式运行 SPlayer （开发环境可以使用 `pnpm dev -- --ozone-platform=x11` 启动） 你也可以直接修改桌面项，而不用每次都手动添加参数运行 <details> <summary>KDE Plasma Wayland</summary> KDE 应该自带了菜单编辑器，你可以 1. 右击 SPlayer 的桌面项 2. 点击 `编辑应用程序...` 3. 在右侧的 `命令行参数` 中将 `%U` 更改为 `--ozone-platform=x11 %U` 4. 保存并退出 </details> <details> <summary>其他 DE/WM</summary> 大致原理差不多，你可以 1. 找到 SPlayer 的桌面项位置（应该在 `/usr/share/applications/SPlayer.desktop`） 2. 复制此文件到 `~/.local/share/applications/SPlayer.desktop` 4. 使用任意文本编辑器打开 5. 找到以 `Exec=` 开头的行，替换为 `Exec=/opt/SPlayer/SPlayer --ozone-platform=x11 %U` 6. 保存并退出 </details> ## Wayland 桌面歌词 这个方案是有瑕疵的，我们为桌面歌词窗口设置了专门的窗口标题（`SPlayer - 桌面歌词`）以方便窗口规则匹配 对于 KWin 窗口规则，可参考 [这条评论](https://github.com/imsyy/SPlayer/issues/920#issuecomment-3938787235) ## 第三方代替 <details> <summary>如果只是需要桌面歌词等，你可以使用兼容的第三方项目</summary><br/> 可以使用由 [lrst6963](https://github.com/lrst6963) 贡献的 桌面歌词 ([Splayer-kde-lyc](https://github.com/lrst6963/Splayer-kde-lyc)) 和 KDE 任务栏歌词组件 ([Splayer-kde-bar-lyc](https://github.com/lrst6963/Splayer-kde-bar-lyc)) 这两个项目都通过 WebSocket 与 SPlayer 连接，可以获取到准确的歌词 btw，本项目名称为 S**P**layer，强迫症.jpg 也可以使用由 [KangweiZhu](https://github.com/KangweiZhu) 维护、[Neokoni](https://github.com/neokoni) 贡献了 SPlayer Mode 的 [lyrics-on-panel](https://github.com/KangweiZhu/lyrics-on-panel) 项目通过 SPlayer 暴露的 API 使用 HTTP GET `/api/control/song-info` 获取当前播放的歌曲与歌词 知名的 [Waylyrics](https://github.com/waylyrics/waylyrics) 当然也能用，不过此项目只能通过 MPRIS 获取歌曲信息，再搜索歌词，所以有时候的歌词不一致，也当然无法应用 SPlayer 的歌词排除设置 </details> ## 结尾 对于影响所有 Linux Wayland 有关的，你可以在这下面讨论；对于仅影响单个问题的进展，可以继续在那个 Sub-issue 里追踪；遇到了新的问题也可以开新的 Issue
kerem commented 2026-02-27 07:11:13 +03:00
Author
Owner
Copy link

@github-actions[bot] commented on GitHub (Nov 28, 2025):

👋 您好 @MoYingJi，感谢提交 Issue！
🚀 我们已经收到您的反馈，会尽快确认你的问题

在等待回复期间，您可以：

<!-- gh-comment-id:3589185666 --> @github-actions[bot] commented on GitHub (Nov 28, 2025): 👋 您好 @MoYingJi，感谢提交 Issue！ 🚀 我们已经收到您的反馈，会尽快确认你的问题 在等待回复期间，您可以： - 📖 查看 [项目文档](https://github.com/imsyy/SPlayer/blob/dev/README.md) - 💬 加入 [交流群](https://qm.qq.com/cgi-bin/qm/qr?k=2-cVSf1bE0AvAehCib00qFEFdUvPaJ_k&jump_from=webapi&authKey=1NEhib9+GsmsXVo2rCc0IbRaVHeeRXJJ0gbsyKDcIwDdAzYySOubkFCvkV32+7Cw) 进行实时讨论 - 🔍 搜索 [现有 Issues](https://github.com/imsyy/SPlayer/issues) 查看是否有类似问题
kerem commented 2026-02-27 07:11:13 +03:00
Author
Owner
Copy link

@zrydnoob commented on GitHub (Dec 12, 2025):

这个问题在v3.0.0-beta.2版本中还未出现，我的电脑上还可以正常运行
更新到3.0.0-beta.6后打开软件出现画屏、闪屏，随后系统卡死，只能重启解决

感谢您的 Issue 解决了我的问题

系统信息
  • OS: Manjaro Linux x86_64
  • DE: KDE Plasma 6.5.3
  • WM: KWin (Wayland)
<!-- gh-comment-id:3645939104 --> @zrydnoob commented on GitHub (Dec 12, 2025): 这个问题在[v3.0.0-beta.2](https://github.com/imsyy/SPlayer/releases/tag/v3.0.0-beta.2)版本中还未出现，我的电脑上还可以正常运行 更新到[3.0.0-beta.6](https://github.com/imsyy/SPlayer/releases/tag/v3.0.0-beta.6)后打开软件出现画屏、闪屏，随后系统卡死，只能重启解决 感谢您的 Issue 解决了我的问题 <details> <summary>系统信息</summary> - OS: Manjaro Linux x86_64 - DE: KDE Plasma 6.5.3 - WM: KWin (Wayland) </details>
kerem commented 2026-02-27 07:11:13 +03:00
Author
Owner
Copy link

@LFRon commented on GitHub (Dec 31, 2025):

Wayland我记得是不能让应用获取自身窗口坐标的,所以桌面歌词应该要走专门适配的API实现

<!-- gh-comment-id:3701564961 --> @LFRon commented on GitHub (Dec 31, 2025): Wayland我记得是不能让应用获取自身窗口坐标的,所以桌面歌词应该要走专门适配的API实现
kerem commented 2026-02-27 07:11:13 +03:00
Author
Owner
Copy link

@github-actions[bot] commented on GitHub (Feb 2, 2026):

🤝 您好 @MoYingJi，感谢您的反馈！我们已经确认该问题，并将在下一个版本中修复

<!-- gh-comment-id:3832671960 --> @github-actions[bot] commented on GitHub (Feb 2, 2026): 🤝 您好 @MoYingJi，感谢您的反馈！我们已经确认该问题，并将在下一个版本中修复
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
dev
dev-nightly
dev-style
dev-bar
dev-plugin
dev-search
dev-copy
dev-yqt
master
old
v3.0.0-nightly
v3.0.0
v3.0.0-beta.9
v3.0.0-beta.8.2025
v3.0.0-beta.7
v3.0.0-beta.6
v3.0.0-beta.5
v3.0.0-beta.4
v3.0.0-beta.3
v3.0.0-beta.2
v3.0.0-beta.1
v3.0.0-alpha.4
v3.0.0-alpha.3
v3.0.0-alpha.2
v3.0.0-alpha.1
v2.0.9
v2.0.8
v2.0.7
v2.0.6
v2.0.5
v2.0.4
v2.0.3
v2.0.2
v2.0.1
v2.0.0
v2.0.0-beta.5
v2.0.0-beta.4
v2.0.0-beta.3
v2.0.0-beta.2
v1.1.7_dev
v1.1.7
v1.1.6
v1.1.5
v1.1.4
v1.1.3
v1.1.2
v1.1.0
v1.0.4
v1.0.0
v0.0.1
Labels
Clear labels   
AM

   
BUG

   
pull-request

Mirrored from GitHub Pull Request

  
不会修复

   
中优先级 P1

   
低优先级 P2

   
已修复

   
已完成

   
无优先级 P3

   
无效

   
无法复现

   
暂置

   
正在处理

   
过期

   
重复

   
重要

   
需要帮助

   
高优先级 P0
No labels
AM
BUG
pull-request
不会修复
中优先级 P1
低优先级 P2
已修复
已完成
无优先级 P3
无效
无法复现
暂置
正在处理
过期
重复
重要
需要帮助
高优先级 P0
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/SPlayer#310
No description provided.