Weston: Difference between revisions
WhyNotHugo (talk | contribs) (Link to existing instructions for XDG_RUNTIME_DIR) |
Prabuanand (talk | contribs) (Added reference to setup-wayland-base script and included Include:Desktop prerequisites) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| 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. | |||
{{:Include:Desktop prerequisites}} | |||
The <Code>setup-wayland-base</Code> script installs and enables [[elogind]] as [[Seat manager|seat manager]], enables [[Repositories#Community|community repository]] and enables [[eudev]] automatically as these are required for Wayland to work. | |||
== Installation == | == Installation == | ||
Steps to install Weston | Steps to install [https://gitlab.freedesktop.org/wayland/weston/ Weston] | ||
* Install weston and necessary dependencies: | |||
{{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 == | |||
You can launch <Code>weston</Code> by issuing the command sway from TTY. {{Cmd|$ weston}} | |||
== Troubleshooting == | |||
== See also == | |||
[https://wayland.pages.freedesktop.org/weston/ Weston] | |||
[[Category:Compositor]] | |||
[[Category:Desktop]] | |||
[[Category:Wayland]] | |||
Latest revision as of 07:13, 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.
- Ensure you have Internet connectivity. If the test fails, setup your Internet access first, before you proceed further.
- Create a non-privileged user account for security reasons, if you skipped this step during Installation.
- Enable community repository.
- Install graphics driver for your video hardware.
The setup-wayland-base script installs and enables elogind as seat manager, enables community repository and enables eudev automatically as these are required for Wayland to work.
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 on a desktop system is recommended in Alpine Linux. Without a fully functional device manager users will not be able to connect to input devices. The alpine-conf package provides setup-devd script to easily install and setup device managers.
Setup eudev.
# setup-devd udev
For more details and other options see eudev.
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