← 返回命令列表

Linux command

weston 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Start Weston compositor

weston

Start with a specific backend

weston --backend=[drm|wayland|x11]

Start with a specific shell

weston --shell=[desktop|fullscreen|kiosk]

Start in windowed mode

weston --backend=x11

Start nested

weston --backend=wayland

Run with Xwayland

weston --xwayland

Specify display socket name

weston -S [wayland-1]

Start with specific configuration file

weston -c [path/to/weston.ini]

说明

Weston is the reference Wayland compositor, serving as both a display server and window manager. It demonstrates Wayland protocol capabilities and provides a functional desktop environment for testing and embedded systems. Weston supports multiple backends for different deployment scenarios: DRM for native Linux framebuffer access, X11 or Wayland backends for running nested inside other display servers, and headless/RDP/VNC backends for remote or testing purposes. Different shells provide various user interface styles: desktop shell for traditional workstation use, fullscreen shell for single-application kiosks, and IVI shell for in-vehicle infotainment systems. Configuration is done through weston.ini. Weston requires access to input devices and display hardware through a seat manager (seatd or elogind). For native mode, the user must have appropriate permissions via the seat mechanism.

参数

-B, --backend=_backend_
Compositor backend: drm (native), x11, wayland, headless, rdp, vnc, pipewire.
--shell=_shell_
Shell plugin: desktop (default), fullscreen, kiosk, ivi.
-S, --socket=_name_
Wayland socket name for clients to connect.
-c, --config=_file_
Path to configuration file. Default is $XDG_CONFIG_HOME/weston.ini or ~/.config/weston/weston.ini.
--no-config
Do not read configuration file.
--modules=_module_
Load additional modules (comma-separated).
--renderer=_name_
Select rendering engine (gl, pixman, vulkan, noop).
--xwayland
Enable X11 application support via Xwayland.
-i, --idle-time=_seconds_
Idle timeout before screen saver.
--log=_file_
Log file path.
-l, --logger-scopes=_scopes_
Comma-separated logger scopes to enable.
--debug
Enable debug protocol extension.
--width=_pixels_
Initial output width (windowed backends).
--height=_pixels_
Initial output height (windowed backends).
--scale=_factor_
Output scale factor.
-h, --help
Display help message.
--version
Display version information.

FAQ

What is the weston command used for?

Weston is the reference Wayland compositor, serving as both a display server and window manager. It demonstrates Wayland protocol capabilities and provides a functional desktop environment for testing and embedded systems. Weston supports multiple backends for different deployment scenarios: DRM for native Linux framebuffer access, X11 or Wayland backends for running nested inside other display servers, and headless/RDP/VNC backends for remote or testing purposes. Different shells provide various user interface styles: desktop shell for traditional workstation use, fullscreen shell for single-application kiosks, and IVI shell for in-vehicle infotainment systems. Configuration is done through weston.ini. Weston requires access to input devices and display hardware through a seat manager (seatd or elogind). For native mode, the user must have appropriate permissions via the seat mechanism.

How do I run a basic weston example?

Run `weston` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does -B, --backend=_backend_ do in weston?

Compositor backend: drm (native), x11, wayland, headless, rdp, vnc, pipewire.