https://github.com/tadd/gnome-wayland-fix-window-op.so

Fix the window operation bugs of GTK3 with preloading/overriding.
https://github.com/tadd/gnome-wayland-fix-window-op.so

gdk gtk3 monkey-patching wayland xdg

Last synced: 21 days ago
JSON representation

Fix the window operation bugs of GTK3 with preloading/overriding.

• Host: GitHub
• URL: https://github.com/tadd/gnome-wayland-fix-window-op.so
• Owner: tadd
• License: lgpl-2.1
• Created: 2023-11-03T17:23:33.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-30T07:32:49.000Z (3 months ago)
• Last Synced: 2024-10-10T22:02:39.659Z (about 1 month ago)
• Topics: gdk, gtk3, monkey-patching, wayland, xdg
• Language: C
• Homepage:
• Size: 27.3 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: COPYING.md

Awesome Lists containing this project

README

        
GNOME on Wayland: Fix `gdk_window_*` Operations

===============================================

This preloaded library fixes some GTK3 window operations like

`gdk_window_raise` to be effective with GNOME/Mutter on Wayland.

For example, you can use the elisp function

[`raise-frame`](https://www.gnu.org/software/emacs/manual/html_node/elisp/Raising-and-Lowering.html#index-raise_002dframe)

normally with PGTK Emacs.

## Scope

[`gdk_window_raise`](https://docs.gtk.org/gdk3/method.Window.raise.html) is

the only function we can fix at this time. We plan to fix others using the

same mechanism.

## Requirements

GNOME extension [Activate Window By

Title](https://extensions.gnome.org/extension/5021/activate-window-by-title/)

needs to be installed.

## Usage

1. `make`.

2. Launch any GTK3 application with

   `LD_PRELOAD=$PWD/gnome-wayland-fix-window-op.so `.

Enjoy your ordinary and normal desktop life, and wait for the canonical specs

and impls to remove this hack.

## Tricks

[`LD_PRELOAD`](https://man7.org/linux/man-pages/man8/ld.so.8.html#ENVIRONMENT)

and [D-Bus](https://www.freedesktop.org/wiki/Software/dbus/).

1. Override a target function with our implementation with `LD_LIBRARY`.

2. If we don't need to change its behavior, call the original function as is.

3. Otherwise, call the D-Bus method

   [activateByTitle](https://github.com/lucaswerkmeister/activate-window-by-title#d-bus-usage)

   with the window title taken from the target function's argument.

## Development

https://github.com/tadd/gnome-wayland-fix-window-op.so

## License

LGPL 2.1. See COPYING.md.

## References

* Satoru Takabayashi, Fumitoshi Ukai, Yusuke Sato, Shinichiro Hamaji, and

  Kazuyuki Shudo. *Hack #61: Using "LD_PRELOAD" to wrap existing functions* in

  [**Binary Hacks**](https://www.oreilly.co.jp/books/4873112885/) (in Japanese).

  O'Reilly Japan, pp 228-230, Nov. 2006.

  * [English page](http://0xcc.net/binhacks/eabout.html) also available

* Wondering why it doesn't work by default? Here is [GTK 3.24's empty

  code.](https://gitlab.gnome.org/GNOME/gtk/-/blob/3.24.43/gdk/wayland/gdkwindow-wayland.c#L3606-3609)