#wayland #messages #requests #proxy #force #sockets #filters-modifies

nightly app filterway

Filter/modify Wayland messages from clients

1 unstable release

0.1.0 May 4, 2024

#1074 in Network programming

Download history 114/week @ 2024-04-28 39/week @ 2024-05-05

153 downloads per month

ISC license

29KB
526 lines

Filterway

is a lightweight Wayland socket proxy that intercepts messages and filters/modifies them. You can use it for, for example, making all applications in a container have the same app_id (apply certain window decorations in certain containers).

Current features:

  • Force app_id - assign all toplevels the same app_id and suppress client-originated set_app_id requests
  • Dump wayland protocol traffic

How to use it

Your main compositor will have created something like /run/user/1000/wayland-0 where 1000 is your user ID.

  1. Build filterway with cargo build
  2. Run filterway /run/user/1000/wayland-0 /run/user/1000/wayland-filtered org.example.testid
  3. Run Wayland applications or another compositor with WAYLAND_DISPLAY=wayland-filtered

Dependencies

~12–22MB
~342K SLoC