From 925c98364a8aaa92b16e50efe7560348279991d8 Mon Sep 17 00:00:00 2001
From: Anders da Silva Rytter Hansen <gitnf@a.rytter.me>
Date: Tue, 15 Sep 2026 16:14:53 +0200
Subject: [PATCH] Update README

---
 README.md | 38 +++++++++++++++++++++++++++++++++-----
 1 file changed, 33 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index d9e7e51..4f66416 100644
--- a/README.md
+++ b/README.md
@@ -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