Wayland Tools

A collection of tools for inspecting and debugging wayland compositors. Currently, there are only two programs, but feel free to open a PR or suggest more :)

Table of Contents

• Wayland Tools
  • How to build
    • How to install
    • How to uninstall
    • I am having trouble installing/building/uninstalling
  • Wayland globals (wayland-globals.c)
  • Wayland outputs (wayland-outputs.c)

How to build

You'll need: meson, ninja and wayland-client, then (assuming you're not familiar with meson):

1. Clone the repo
2. Inside the repo folder, run meson build (here "build" could be anything, it doesn't matter)
3. Run ninja -C build (assuming you used "build" in the previous step).

Bash script for the lazy:

git clone https://github.com/Diegovsky/wayland-tools;
cd wayland-tools;
meson build;
ninja -C build

You'll find the executables inside the build/ folder (again, assuming you used "build" in step 2).

How to install

Basically, the same thing as building, except the ninja subcommand is install and you need write permissions to where you want the files to be installed (by default, it's /usr/local/bin).

sudo ninja -C build install

How to uninstall

Also the same thing as installing, except the subcommand is uninstall:

sudo ninja -C build uninstall

I am having trouble

Don't be afraid to open an issue so I can leave more user friendly instructions. Though, I believe it's already pretty clear.

Wayland Globals

This executable connects to the compositor and lists all supported globals.

Wayland Outputs

This executable lists all outputs detected. If the compositor supports xdg_output protocol, it shows aditional information.