# 12to11 for Fedora and Enterprise Linux

This repository contains the RPM packaging for [12to11](https://github.com/fish4terrisa-MSDSM/12to11), a Wayland-to-X11 protocol translator. Packages are built in the [andersrh/12to11 COPR project](https://copr.fedorainfracloud.org/coprs/andersrh/12to11/).

## What is 12to11?

12to11 is a small Wayland compositor that runs as a regular X11 client. It creates a Wayland socket and displays Wayland applications as normal X11 windows. This makes it possible to run Wayland-only applications, such as [Waydroid](https://waydro.id/), from an X11 session without running Weston as a nested compositor.

The package is built with EGL/OpenGL ES 2.0 rendering enabled. 12to11 also implements the Wayland data-device and X11 selection handling needed for clipboard integration between Wayland applications and the X11 desktop.

This package tracks the actively developed [fish4terrisa-MSDSM fork](https://github.com/fish4terrisa-MSDSM/12to11) and is licensed under GPL-3.0-only.

## Example: Waydroid running through 12to11

The following screenshot shows Waydroid running as a Wayland application through 12to11 on an X11 desktop:

![Waydroid running through 12to11](screenshots/waydroid%20on%2012to11.png)

## Supported targets

The COPR project currently provides builds for:

- Fedora 43, Fedora 44, Fedora 45, and Fedora Rawhide
- EPEL 9 and EPEL 10
- AlmaLinux 10 with EPEL (x86_64-v2)

The COPR builds are unofficial and are provided as-is.

## Installation from COPR

The `dnf copr` command is provided by `dnf-plugins-core`. Install it first if it is not already available.

### Fedora

```bash
sudo dnf install -y dnf-plugins-core
sudo dnf copr enable andersrh/12to11
sudo dnf install -y 12to11
```

### AlmaLinux, RHEL-compatible distributions, and EPEL

The EL builds use `libXpresent` from the [xlibre/xlibre-xserver COPR](https://copr.fedorainfracloud.org/coprs/g/xlibre/xlibre-xserver/), because `libXpresent` is not available in the standard EL repositories.

On AlmaLinux, install and enable EPEL if necessary, then enable both COPR repositories:

```bash
sudo dnf install -y epel-release dnf-plugins-core
sudo dnf copr enable @xlibre/xlibre-xserver
sudo dnf copr enable andersrh/12to11
sudo dnf install -y 12to11
```

On RHEL-compatible distributions where `epel-release` is not available directly, enable EPEL using the distribution's documented procedure before installing 12to11.

## Running 12to11 with Waydroid

Start 12to11 in an X11 session. The `-printsocket` option prints the Wayland socket name while the compositor continues running:

```bash
RENDERER=egl 12to11 -printsocket
```

For example, it may print:

```text
wayland-1
```

Keep that process running. In another terminal, use the socket name printed by 12to11:

```bash
export WAYLAND_DISPLAY=wayland-1
waydroid show-full-ui
```

If 12to11 prints a different socket name, use that name instead. Do not assume that the socket is always `wayland-1`.

If the Waydroid session is not already running, start it before showing the UI:

```bash
waydroid session start
```

The exact Waydroid setup still depends on the Android image, kernel support, graphics driver, and whether Google Apps are installed.

## Building the RPM locally

The spec file uses the upstream GitHub snapshot and the project's legacy `imake`/`xmkmf` build system. The package is built with EGL support enabled by the upstream `12to11.conf`.

### 1. Install packaging tools

Fedora:

```bash
sudo dnf install -y rpm-build rpmdevtools dnf-plugins-core
```

AlmaLinux, RHEL-compatible distributions, and EPEL:

```bash
sudo dnf install -y epel-release rpm-build rpmdevtools dnf-plugins-core
sudo dnf copr enable @xlibre/xlibre-xserver
```

### 2. Install the build dependencies

Run this from the repository checkout:

```bash
sudo dnf builddep -y 12to11.spec
```

On EL systems, the xlibre COPR must be enabled first so that `libXpresent-devel` can be resolved.

### 3. Build the package

```bash
rpmdev-setuptree
cp 12to11.spec ~/rpmbuild/SPECS/
spectool -g --directory ~/rpmbuild/SOURCES ~/rpmbuild/SPECS/12to11.spec
rpmbuild -ba ~/rpmbuild/SPECS/12to11.spec
```

The resulting files are written to:

```text
~/rpmbuild/RPMS/$(uname -m)/
~/rpmbuild/SRPMS/
```

Install the locally built package with:

```bash
sudo dnf install ~/rpmbuild/RPMS/$(uname -m)/12to11-0-*.rpm
```

### Building in COPR

COPR reads `12to11.spec`, downloads the source archive specified by `Source0`, installs the `BuildRequires`, and builds the package in a clean chroot for each enabled target. The EL builds also have the xlibre/xlibre-xserver COPR configured as an external repository so that `libXpresent-devel` is available during the build.

To update the source snapshot, change the `commit` and `snapdate` macros in `12to11.spec`, update the changelog, and submit the changed spec file to the COPR project.

## Known limitations

12to11 is not a complete Wayland compositor. According to the upstream project:

- Touchscreen support is not implemented.
- Device switching in DMA-BUF feedback is not implemented.
- It requires X.Org Server 1.20 or later.
- It works best with a compositing window manager that supports the EWMH frame-synchronization protocol.
- Upstream testing has primarily been done with GNOME Shell; other window managers may have compatibility issues.

For Waydroid controlled with a mouse on an X11 desktop, the missing touchscreen support is usually not a problem.

## Links

- [12to11 upstream project](https://github.com/fish4terrisa-MSDSM/12to11)
- [12to11 COPR repository](https://copr.fedorainfracloud.org/coprs/andersrh/12to11/)
- [COPR xlibre/xlibre-xserver repository](https://copr.fedorainfracloud.org/coprs/g/xlibre/xlibre-xserver/)