Skip to content

fix(wayland): add downgrade path for Mutter compositor, correct READM… - #6

Merged
ChouChiu merged 3 commits into
ChouChiu:mainfrom
Youwenqwq:main
Oct 2, 2026
Merged

ChouChiu merged 3 commits into
ChouChiu:mainfrom
Youwenqwq:main

Conversation

@Youwenqwq

@Youwenqwq Youwenqwq commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Summary

The Mutter compositor GNOME uses actually doesn't support layer-shell protocol, and its developer explicitly refuses to add support (ref: layer-shell protocol support ). This PR adds downgrade path for it so that basic functions would work properly, plus corrected README.md.

NOTE: To enable Always On Top in GNOME, press Alt + Space on the window and select Always On Top option. It's also good to turn on Always on Visible Workspace

Screenshot

image

Validation

Tested that this modification works on my Fedora Workstation 44 (GNOME 50.5, Wayland)

Ran

cargo fmt --all -- --check
cargo clippy --locked --all-targets --all-features -- -D warnings
cargo test --locked --all-targets --all-features
cargo build --locked --release
cargo docs

GNOME 用的 Mutter 合成器不支持 layer-shell 且这家伙也不想支持这个协议(参见 layer-shell protocol support)。于是提了个 PR 提供了一个降级路径,让这个程序能正常工作,窗口能正常拖动,顺带更新了一下 README 的一些描述。

在我的 Fedora Workstation 44 (GNOME 50.5, Wayland) 环境下测试通过,工作正常。

需要注意的是,由于降级路径和 GNOME 限制,想让歌词始终置顶,最好在歌词窗口上按下键盘的 Alt + Space 然后打开 "始终置于顶层" 和 "始终在所有工作区可见"

@ChouChiu

ChouChiu commented Oct 2, 2026

Copy link
Copy Markdown
Owner

请问您使用的模型是,让我看看有没有让 Opus 大人审查的必要(

@Youwenqwq

Copy link
Copy Markdown
Contributor Author

请问您使用的模型是,让我看看有没有让 Opus 大人审查的必要(

使用 Kimi K3

@ChouChiu

ChouChiu commented Oct 2, 2026

Copy link
Copy Markdown
Owner

好的,我会在修好 CI 并稍作审查后合并

ChouChiu and others added 2 commits October 2, 2026 19:42
…er shell

Localize the overlay window title, which the fallback now shows in the
window switcher, and keep it in sync with the language. Share the cursor
reset between both drag paths, drop a guard the fallback can never reach,
and document what the fallback gives up in README and AGENTS.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ChouChiu
ChouChiu merged commit 4baabc4 into ChouChiu:main Oct 2, 2026
4 checks passed
@ChouChiu

ChouChiu commented Oct 2, 2026

Copy link
Copy Markdown
Owner

十分感谢您的贡献!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants