Skip to content

Add Wayland/GNOME support#156

Open
juljimm wants to merge 1 commit intossokolow:masterfrom
juljimm:master
Open

Add Wayland/GNOME support#156
juljimm wants to merge 1 commit intossokolow:masterfrom
juljimm:master

Conversation

@juljimm
Copy link

@juljimm juljimm commented Feb 3, 2026

Add full Wayland support for GNOME Shell using the Window Calls extension.

Features:

  • Window management via D-Bus (move, resize, maximize, minimize)
  • Cycle through window sizes (left, right, corners, etc.)
  • Vertical and horizontal maximize with toggle support
  • State persistence between invocations
  • GNOME custom keybindings integration (since Wayland blocks global hotkeys)

New files:

  • quicktile/wayland_wm.py: Wayland window manager backend
  • quicktile/wayland_keybinder.py: Wayland keybinding support
  • setup-wayland-keybindings.sh: GNOME keybindings configurator
  • install-wayland.sh: One-line installer for Wayland
  • run-quicktile.sh: Wrapper script for running QuickTile
  • WAYLAND.md: Detailed Wayland documentation
  • tests/test_wayland_wm.py: Unit tests for Wayland backend

Requirements:

Add full Wayland support for GNOME Shell using the Window Calls extension.

Features:
- Window management via D-Bus (move, resize, maximize, minimize)
- Cycle through window sizes (left, right, corners, etc.)
- Vertical and horizontal maximize with toggle support
- State persistence between invocations
- GNOME custom keybindings integration (since Wayland blocks global hotkeys)

New files:
- quicktile/wayland_wm.py: Wayland window manager backend
- quicktile/wayland_keybinder.py: Wayland keybinding support
- setup-wayland-keybindings.sh: GNOME keybindings configurator
- install-wayland.sh: One-line installer for Wayland
- run-quicktile.sh: Wrapper script for running QuickTile
- WAYLAND.md: Detailed Wayland documentation
- tests/test_wayland_wm.py: Unit tests for Wayland backend

Requirements:
- GNOME Shell
- Window Calls extension (https://extensions.gnome.org/extension/4724/window-calls/)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@ssokolow
Copy link
Owner

ssokolow commented Feb 4, 2026

Thanks. :)

Is there a particular distro you'd recommend I pull off https://www.osboxes.org/ for testing this?

(I'm very much a KDE user and don't want to gamble on apt-geting GNOME mucking up something in which implementation of some system service gets run.)

@juljimm
Copy link
Author

juljimm commented Feb 4, 2026

Thanks. :)

Is there a particular distro you'd recommend I pull off https://www.osboxes.org/ for testing this?

(I'm very much a KDE user and don't want to gamble on apt-geting GNOME mucking up something in which implementation of some system service gets run.)

Hi! Ubuntu would be a good choice since that's what I use for development. Any recent LTS version (22.04 or 24.04) should work fine — they come with GNOME by default.

@ssokolow
Copy link
Owner

ssokolow commented Feb 4, 2026

Thanks. :)
Is there a particular distro you'd recommend I pull off https://www.osboxes.org/ for testing this?
(I'm very much a KDE user and don't want to gamble on apt-geting GNOME mucking up something in which implementation of some system service gets run.)

Hi! Ubuntu would be a good choice since that's what I use for development. Any recent LTS version (22.04 or 24.04) should work fine — they come with GNOME by default.

Funny thing about that. I'm on Kubuntu 24.04 LTS right now (granted, with snapd ripped out and blacklisted and replaced with flatpaks), so it really is just "I don't want to risk a GNOME installation messing with which providers get started for which D-Bus services.)

...so yeah. Shouldn't be a problem. I'll try to fit it in for some time over the next few days. If it turns out GNOME is still as bad at running at a usable speed in VirtualBox as I remember, maybe I'll pull out one of the hand-me-down laptops I was planning to use to test out the KDE Wayland session without risking my daily driver desktop.

@ssokolow
Copy link
Owner

ssokolow commented Feb 8, 2026

Sorry for the delay. I forgot I had some stuff running in KVM that I normally don't need to leave running for an extended period of time and that VirtualBox's AMD-V support doesn't work at the same time as KVM's.

I'd rather not futz around with adding a new KVM-based VM but I'll try to get that wound down as quickly as possible so I can spin up the Ubuntu VM.

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