summaryrefslogtreecommitdiffstats
path: root/chromium/components/exo/README.md
blob: 69aa54ab8fcc809c60bbd0cb0d9231d9d7dc5f74 (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
Exo implements a display server on top of the Aura Shell. It uses the
[Wayland protocol](https://wayland.freedesktop.org/docs/html/)
to communicate with clients. For a general introduction to Wayland see
https://wayland-book.com/.

Current clients of Exo include:

* ARC++ (Android apps on Chrome OS)
* Crostini (Linux apps on Chrome OS)
* [Lacros](https://chromium.googlesource.com/chromium/src/+/main/docs/lacros.md)
* PluginVM

In addition to the core Wayland protocol, Exo supports a number of protocol
extensions. Some are third-party; see
[//third_party/wayland-protocols/README.chromium](https://chromium.googlesource.com/chromium/src/+/main/third_party/wayland-protocols/README.chromium).
Others are Chromium-specific.

A few noteworthy extensions (this list is not at all exhaustive):

* zaura_shell
  * A Chromium-specific protocol used by all Exo clients. See
    [//components/exo/wayland/protocol/aura-shell.xml](wayland/protocol/aura-shell.xml)
    and [//components/exo/wayland/zaura_shell.h](wayland/zaura_shell.h)
* zcr_remote_shell
  * A Chromium-specific protocol used exclusively by ARC++. See
    [//components/exo/wayland/zcr_remote_shell.h](wayland/zcr_remote_shell.h) and
    [//components/exo/client_controlled_shell_surface.h](client_controlled_shell_surface.h)
* zwp_fullscreen_shell
  * A third-party protocol, used in Chromium only by Chromecast. See
    [//components/exo/wayland/zwp_fullscreen_shell.h](wayland/zwp_fullscreen_shell.h)