Skip to content

dwapp/wlhax

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

88 Commits
docs
docs
 
 
ui
ui
 
 
.gitignore
.gitignore
 
 
.goreleaser.yaml
.goreleaser.yaml
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
changelog.yml
changelog.yml
 
 
client.go
client.go
 
 
clients.go
clients.go
 
 
dashboard.go
dashboard.go
 
 
exline.go
exline.go
 
 
go.mod
go.mod
 
 
go.sum
go.sum
 
 
main.go
main.go
 
 
protocol.go
protocol.go
 
 
proxy.go
proxy.go
 
 
socket.go
socket.go
 
 
ui.go
ui.go
 
 
wl_buffer.go
wl_buffer.go
 
 
wl_callback.go
wl_callback.go
 
 
wl_compositor.go
wl_compositor.go
 
 
wl_display.go
wl_display.go
 
 
wl_keyboard.go
wl_keyboard.go
 
 
wl_output.go
wl_output.go
 
 
wl_pointer.go
wl_pointer.go
 
 
wl_registry.go
wl_registry.go
 
 
wl_seat.go
wl_seat.go
 
 
wl_shm.go
wl_shm.go
 
 
wl_subcompositor.go
wl_subcompositor.go
 
 
wl_subsurface.go
wl_subsurface.go
 
 
wl_surface.go
wl_surface.go
 
 
wl_touch.go
wl_touch.go
 
 
wp_cursor_shape_manager.go
wp_cursor_shape_manager.go
 
 
wp_fractional_scale.go
wp_fractional_scale.go
 
 
wp_single_pixel_buffer.go
wp_single_pixel_buffer.go
 
 
wp_viewporter.go
wp_viewporter.go
 
 
xdg_shell.go
xdg_shell.go
 
 
zwp_idle_inhibit.go
zwp_idle_inhibit.go
 
 
zwp_linux_dmabuf.go
zwp_linux_dmabuf.go
 
 
zxdg_decoration.go
zxdg_decoration.go
 
 

Repository files navigation

wlhax

Wayland proxy and terminal dashboard for inspecting clients, protocol objects, and surface state in real time.

This fork is based on:

What It Does

  • Proxies a Wayland display socket
  • Forwards protocol traffic between clients and the real compositor
  • Tracks protocol objects, globals, buffers, and surfaces per client
  • Renders the current state in a TUI built with vaxis

Quick Start

go build
WAYLAND_DISPLAY=wayland-0 ./wlhax

Then start a client against the proxy socket shown in the status bar, or launch one from inside wlhax with :exec <command>.

Controls

  • Left / Right, h / l: switch tabs
  • Up / Down, j / k: move selection
  • Space: fold or unfold the current category
  • :: command mode
  • :exec <command>: launch a client
  • :slow, :fast, :block, :unblock, :clear, :quit

Documentation

About

[Fork] Wayland proxy that monitors and displays various application state, such as the current surface tree, in a nice little TUI.

Resources

Readme

License

GPL-3.0 license
Activity
Custom properties

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 4

0.2.2 Latest
Apr 7, 2026
+ 3 releases

Packages

 
 
 

Contributors 1

Languages