anders/12to11-rpm
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update README

Browse source
This commit is contained in:
Anders da Silva Rytter Hansen 2026-09-15 16:14:53 +02:00
commit 925c98364a
1 changed files with 33 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

38
README.md
View file

@ -1,6 +1,6 @@
# 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/).
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/). The repository also builds `12to11-autostart`, a small companion package that launches 12to11 automatically when an X11 session begins.
## What is 12to11?
@ -53,9 +53,21 @@ sudo dnf install 12to11
On RHEL-compatible distributions where `epel-release` is not available directly, enable EPEL using the distribution's documented procedure before installing 12to11.
## Starting 12to11 automatically
The optional `12to11-autostart` package installs `/etc/xdg/autostart/12to11.desktop`, so desktop environments that follow the XDG autostart specification launch 12to11 at the start of each X11 session:
```bash
sudo dnf install 12to11-autostart
```
The entry uses `NoDisplay=true`, so it does not appear in application menus. To disable it for a single user, copy the file to `~/.config/autostart/` and add `Hidden=true`.
When 12to11 is started this way it listens on the first free Wayland socket, normally `wayland-0`.
## Running 12to11 with Waydroid
Start 12to11 in an X11 session. The `-printsocket` option prints the Wayland socket name while the compositor continues running:
Start 12to11 in an X11 session. If `12to11-autostart` is installed, 12to11 is already running when the session starts and this step can be skipped. The `-printsocket` option prints the Wayland socket name while the compositor continues running:
```bash
RENDERER=egl 12to11 -printsocket
@ -105,7 +117,7 @@ If you are running 12to11 on a non-default Wayland socket, export the socket nam
## 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`.
The spec file builds the upstream GitHub release tarball using the project's Makefile, with EGL support enabled (the upstream default).
### 1. Install packaging tools
@ -141,6 +153,14 @@ spectool -g --directory ~/rpmbuild/SOURCES ~/rpmbuild/SPECS/12to11.spec
rpmbuild -ba ~/rpmbuild/SPECS/12to11.spec
```
`12to11-autostart` needs no downloaded source — its `Source0` is the `12to11.desktop` file in this repository:
```bash
cp 12to11-autostart.spec ~/rpmbuild/SPECS/
cp 12to11.desktop ~/rpmbuild/SOURCES/
rpmbuild -ba ~/rpmbuild/SPECS/12to11-autostart.spec
```
The resulting files are written to:
```text
@ -151,14 +171,22 @@ The resulting files are written to:
Install the locally built package with:
```bash
sudo dnf install ~/rpmbuild/RPMS/$(uname -m)/12to11-0-*.rpm
sudo dnf install ~/rpmbuild/RPMS/$(uname -m)/12to11-*.rpm
```
`12to11-autostart` is a `noarch` package, so it is written to `~/rpmbuild/RPMS/noarch/` instead:
```bash
sudo dnf install ~/rpmbuild/RPMS/noarch/12to11-autostart-*.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.
`12to11-autostart` is built from `12to11-autostart.spec` in the same way. Its `Source0` is the `12to11.desktop` file in this repository rather than a remote archive, so the file must be available alongside the spec file (for example, committed to the same COPR source repository).
To update to a new upstream release, change `Version` in `12to11.spec`, update the changelog, and submit the changed spec file to the COPR project.
## Known limitations