aboutsummaryrefslogtreecommitdiff
path: root/desktop/weston/README.SBo
blob: b7a939af798d02bc8f1a10eceea85efb3311165e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
Weston:  reference implementation of a Wayland compositor.
==========================================================

This README is current as of Weston 9.0.0.

*** NOTE ***
------------

This is the bleeding edge version of this SlackBuild that is ONLY compatible
with Slackware Current which has been relatively newly PAM-ified as of the
time of writing (May, 2020).

If you are running Slackware stable (14.2 at the time of writing), you are NOT
in the right place. Please utilize the Slackbuild from slackbuilds.org ( git:
https://git.slackbuilds.org/slackbuilds/ ).

In addition to this SlackBuild not working unless your Slackware install is
PAM-ified, Weston >= 8.0.0 will not work on Slackware 14.2 as the graphics
stack is simply too old.

Introduction
------------

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. It also provides a
library allowing other projects to build their own full-featured
environments on top of Weston's core.

A small suite of example or demo clients are also provided: though they
can be useful in themselves, their main purpose is to be an example or
test case for others building compositors or clients.


Slackware-specific Information
------------------------------

*****************************************
IMPORTANT:  MANUAL INTERVENTION REQUIRED.
*****************************************

This SlackBuild of Weston takes a fairly "hands off" approach, and there
are a few things users need to be aware of.

To launch Weston, here are some required steps.

Please note that setting weston-launch suid root is NOT required any longer
under PAM-ified Slackware Current.

1. If you do not have another script exporting XDG_RUNTIME_DIR, you
should enable the one that comes with this SlackBuild:

	# chmod +x /etc/profile.d/weston.sh
		(or .csh, depending on your shell)

(NOTE: You may want to grep your /etc/profile.d directory for other
scripts setting XDG_RUNTIME_DIR before doing this. AlienBob's ktown Plasma5
install, for instance, already includes a script that sets up XDG_RUNTIME_DIR,
so doubling up by doing Step 1 above may cause unwanted behaviour.)


2. Logout (if necessary) and re-login as root.

Once you've logged out and back in as root, run:

	`exec weston-launch -u $USER`

where $USER is the username of the normal user you would like to launch Weston
as.

To launch with Xwayland support, run:

	`exec weston-launch -u $USER -- --xwayland`

You can use the Ctrl+Alt+Backspace keyboard combination to kill Weston.


Optional Dependencies
---------------------

At the present time, the only optional dependency for this SlackBuild is
colord, which is disabled by default. That is because colord pulls in many
dependencies, while building Weston without colord requires no dependencies at
all on Slackware current, which may be more desirable for users that just want
to quickly test out Wayland by getting Weston up and running.

If you would like to enable colord functionality in this SlackBuild,
set the USE_COLORD variable to "true" before running the SlackBuild.


Known Issues
------------

* I have not had success getting Weston to launch with the proprietary nvidia
drivers in use. YMMV. I have had the best luck with the Intel KMS drivers.

* In testing 8.0.0 on the newly PAM-ified Slackware current, I have found that
after running Ctrl+Alt+Backspace to quit, I am brought back to a blank,
black screen. If this happens, try waiting a few seconds and then hit
Ctrl+Alt+F2 (for instance) followed by Ctrl+Alt+F1 to get back to the console.

* I want to stress and emphasize that this is still relatively experimental
software, that talks to your hardware at a fairly low level. For the most
part, I have not had any major issues, but I have seen some odd bugs and
behaviour, including Weston hard-locking my system upon exit and having to
reboot. I have also returned to my shell to find that some keystrokes I had
inputted while using Weston had been inputted into my console with a series of
"Command not found" errors. I do not believe Weston has been widely tested on
non-systemd/logind systems such as Slackware. Use at your own risk.