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.