Treeland prelaunch splash v1
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.
treeland_prelaunch_splash_manager_v1
This interface is a manager for creating prelaunch splash screens. A prelaunch splash screen is a placeholder surface that is shown before an application's main window is mapped. This helps to improve the perceived startup time.
It is particularly useful for application launchers to provide immediate feedback to the user.
create_splash(app_id: string, sandbox_engine_name: string, icon_buffer: object<wl_buffer>)
Argument | Type | Description |
|---|---|---|
| app_id | string | the application ID |
| sandbox_engine_name | string | the sandbox engine / security context name (required, non-empty) |
| icon_buffer | object<wl_buffer>allow null | optional icon image as wl_buffer (e.g. wl_shm) |
Creates a new prelaunch splash screen.
The `app_id` is a string that identifies the application. The compositor will use this ID together with `sandbox_engine_name` to match the splash screen with the actual application window when it appears. This matching mechanism should also work for XWayland windows.
Callers MUST provide a non-empty `sandbox_engine_name` string which identifies the sandboxing/container.
If there is already an active (not-yet-completed) splash for the same `sandbox_engine_name` and `app_id`, the compositor will silently ignore this request (no new splash will be created and no error is raised).
Compositor Support
| treeland_prelaunch_splash_manager_v1 | ↓ | ||
| Compositors | |||
| Cage | 0.3.0 | x | |
| COSMIC | 1.11.0 | x | |
| flakewm | 3.0.5 | x | |
| GameScope | 3.17.0 | x | |
| Hyprland | 0.57.2 | x | |
| Jay | 1.14.0 | x | |
| KWin | 6.7 | x | |
| Labwc | 0.20.2 | x | |
| Louvre | 2.14.1 | x | |
| Mango | 0.16.3 | x | |
| Mir | 2.26 | x | |
| Muffin | 6.7.4 | x | |
| Mutter | 51 | x | |
| niri | 26.04 | x | |
| phoc | 0.55 | x | |
| Pila | 0.5.1 | x | |
| Qtile | 0.37.1 | x | |
| river | 0.5.0 | x | |
| Sway | 1.11 | x | |
| Treeland | 0.8.0 | 1 | |
| Wayfire | 0.9.0 | x | |
| Weston | 15.0.1 | x | |
Copyright
SPDX-FileCopyrightText: 2025 UnionTech Software Technology Co., Ltd. SPDX-License-Identifier: MIT