Treeland app ID resolver v1

resolve application identifiers for treeland

Warning! This protocol is EXPERIMENTAL and under active development. It may change at any time, including in backward-incompatible ways, without incrementing the interface major version and without prior notice. No compatibility guarantees of any kind are provided. Clients and compositors must track the upstream definition in treeland-protocols and must not rely on the current interface names, requests, events, or semantics remaining stable across releases.

manager for app id resolver

Create a resolver object. Typically exactly one privileged helper (a Wayland client with DBus access) binds this interface and serves identification requests coming from the compositor.

destroy()
destroy the manager
get_resolver(id: new_id<treeland_app_id_resolver_v1>)
Argument
Type
Description
idnew_id<treeland_app_id_resolver_v1>
create/bind a resolver object

Create or bind a resolver object. Only one resolver may be registered per session. Treeland is a multi-user compositor; different user sessions may each register their own resolver. If a resolver is already bound in the same session, the compositor will report an error on the manager and will NOT create a new resolver object for this request.

Argument
Value
Description
resolver_already_exists1
A resolver is already registered in this session with the manager

treeland_app_id_resolver_v1

Deprecatedversion 1
app id resolver

The compositor sends identify_request with a unique request_id and a pidfd. The client must answer exactly once via respond(request_id, app_id). If resolution fails respond with an empty string.

respond(request_id: uint, app_id: string, sandbox_engine_name: string)
Argument
Type
Description
request_iduint
the request ID from identify_request
app_idstring
the resolved application identifier, or empty string on failure
sandbox_engine_namestring
the sandbox engine / security context name (required, non-empty)
respond with app id and sandbox_engine_name (empty app_id on failure)

Respond to an identify_request. The sandbox_engine_name must be provided and matches the context in which the process is running (container, sandbox, etc). If resolution fails, respond with an empty app_id.

destroy()
destroy resolver
identify_request(request_id: uint, pidfd: fd)
Argument
Type
Description
request_iduint
monotonic id generated by compositor
pidfdfd
pidfd referencing the target process
ask client to resolve pidfd to application id

Sent by the compositor to ask the helper to resolve a process to an application identifier.


Compositor Support

treeland_app_id_resolver_manager_v1↓
Compositors
CageCage0.3.0
x
COSMICCOSMIC1.11.0
x
flakewm3.0.5
1
GameScopeGameScope3.17.0
x
HyprlandHyprland0.57.2
x
Jay1.14.0
x
KWinKWin6.7
x
LabwcLabwc0.20.2
x
LouvreLouvre2.14.1
x
MangoMango0.16.3
x
MirMir2.26
x
MuffinMuffin6.7.4
x
MutterMutter51
x
niriniri26.04
x
phocphoc0.55
x
Pila0.5.1
x
QtileQtile0.37.1
x
riverriver0.5.0
x
SwaySway1.11
x
TreelandTreeland0.8.0
1
WayfireWayfire0.9.0
x
WestonWeston15.0.1
x

SPDX-FileCopyrightText: 2025 UnionTech Software Technology Co., Ltd. SPDX-License-Identifier: MIT