Weston: Difference between revisions

Revision as of 05:05, 9 January 2025

Weston is the reference implementation of a Wayland compositor, as well as a useful environment in and of itself.

Out of the box, Weston provides a very basic desktop, or a full-featured environment for non-desktop uses such as automotive, embedded, in-flight, industrial, kiosks, set-top boxes and TVs.

Installation

Steps to install Weston

Install weston and necessary dependencies:

# apk add weston weston-backend-drm seatd weston-backend-wayland weston-shell-desktop weston-terminal font-dejavu

Configuration

Set up eudev

Setting up eudev as device manager on a desktop system is recommended. The alpine-conf package provides setup-devd script to easily install and setup device managers.

To set up eudev, issue the command:

# setup-devd udev

Setup up a seat manager

Wayland compositors need raw access to input and output devices. This is mediated by a seat manager.

Configure either seatd or elogind as both are supported. However using both may lead to conflicts.

If seatd is used, Set up XDG_RUNTIME_DIR.

Starting weston

You can launch weston by issuing the command sway from TTY.

$ weston

@@ Line 1: / Line 1: @@
+[https://wayland.pages.freedesktop.org/weston/ Weston] is the reference implementation of a [[Wayland]] compositor, as well as a useful environment in and of itself.
+Out of the box, Weston provides a very basic desktop, or a full-featured environment for non-desktop uses such as automotive, embedded, in-flight, industrial, kiosks, set-top boxes and TVs.
 == Installation ==
-Steps to install [https://gitlab.freedesktop.org/wayland/weston/ Weston] on Alpine 3.20
+Steps to install [https://gitlab.freedesktop.org/wayland/weston/ Weston]
 * Install weston and necessary dependencies:
- doas apk add weston weston-backend-drm seatd weston-backend-wayland weston-shell-desktop weston-terminal font-dejavu
+{{Cmd|# apk add weston weston-backend-drm seatd weston-backend-wayland weston-shell-desktop weston-terminal font-dejavu}}
+== Configuration ==
+=== Set up eudev ===
+{{:Include:Setup_Device_Manager}}
+=== Setup up a seat manager ===
+Wayland compositors need raw access to input and output devices. This is mediated by a [[seat manager]].
+Configure either [[seatd]] or [[elogind]] as both are supported. However using both may lead to conflicts.
+If [[seatd]] is used, Set up [[XDG_RUNTIME_DIR]].
+== Starting weston ==
-* Set up [[Seatd]] and [[eudev]]:
+You can launch <Code>weston</Code> by issuing the command sway from TTY. {{Cmd|$ weston}}
- doas rc-update add seatd
+== Troubleshooting ==
- doas adduser $USER seat
- doas setup-devd udev
-* Set up [[XDG_RUNTIME_DIR]].
+== See also ==
-* Reboot
-* Start weston with: <code>weston</code>
-==== References ====
+[https://wayland.pages.freedesktop.org/weston/ Weston]
-https://github.com/crftbt/OpenSourcedMe/blob/main/alpine/weston.md
 [[Category:Compositor]]
 [[Category:Desktop]]
 [[Category:Wayland]]