Need help?

Join our Discord to ask questions!

Take a look



In this page, we have two objectives,

  • Install Zen Mirror to Meta Quest 2 / Pro
  • Install our desktop environment, Zen to Ubuntu 22.04 / Arch Linux

Zwin and Zen are all beta versions. Some of them may not work well in your environment.
We will improve the quality of these in future development and add new features according to the Roadmap.

Install packages

Ubuntu 22.04

$ sudo apt-get update
$ sudo apt-get install adb clang cmake git libcairo2-dev \
      libcglm-dev libdrm-dev libegl-mesa0 libgbm-dev \
      libgles-dev libglm-dev libglu1-mesa-dev libjpeg-dev \
      librsvg2-dev libwayland-dev libwlroots-dev meson pkg-config \

It might be a good idea to install applications that work in Zen. To complete Zen walkthrough, you need weston to start the terminal, so it is highly recommended to install it.

# Optional
$ sudo apt-get install weston
$ sudo apt-get install google-chrome-stable
# If apt-get does not work, you can download Chrome from
# or install Chromium instead.

Arch Linux

You can use any AUR helper. In this page, we will show examples using yay.

$ yay -Syu
$ yay -S --needed \
  git sudo clang make cmake meson ninja python python-pip curl unzip pkgconf \
  wayland wayland-protocols wlroots0.15 glm glew librsvg ttf-ubuntu-font-family

It might be a good idea to install applications that work in Zen.

# Optional
$ yay -S --needed weston google-chrome nautilus

Prepare build scripts

$ git clone
$ cd zen-release-manager
$ pip3 install -r requirements.txt
$ ./zen-release configure ./release/latest.yaml

From this point forward, we will work in the zen-release-manager directory.

Enable developer mode on Meta Quest

See Meta Quest Developer Center.

Install Zen Mirror

Download APK file.

$ ./zen-release download zen-mirror

Check that ADB recognize your Meta Quest.

$ adb devices
List of devices attached
1WMHH815K10424 device # OK

If you see following output, you need to allow USB debugging on Meta Quest.

List of devices attached
1WMHH815K10424 unauthorized # NG

Install APK file to Meta Quest.

$ adb install ./build/zen-mirror/zen-mirror.apk

Did you find Zen Mirror in "Unknown Sources" apps? Well done!

Build and install Zen

If you are using Arch Linux, please execute following command beforehand.

$ export PKG_CONFIG_PATH="/usr/lib/wlroots0.15/pkgconfig:/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig:${PKG_CONFIG_PATH}"

Build and install protocol.

$ ./zen-release build protocol
$ sudo ./zen-release install protocol

Build and install dependent libraries.

This may take more than 10 minutes.

$ ./zen-release build deps
$ sudo ./zen-release install deps

Build and install Zen.

$ ./zen-release build desktop
$ sudo ./zen-release install desktop

Generate default config.toml

A recommended configuration file will be generated in the appropriate location.
See Configuration.

$ ./zen-release generate-config