Add aether protocol handler registration

Author: bjarneo

.github/workflows/aur.yml

@@ -62,6 +62,7 @@ jobs:
 
               cd "${srcdir}/aether-${pkgver}"
               install -Dm644 build/linux/aether.desktop "${pkgdir}/usr/share/applications/aether.desktop"
+              install -Dm644 li.oever.aether.url-handler.desktop "${pkgdir}/usr/share/applications/li.oever.aether.url-handler.desktop"
               install -Dm644 icon.png "${pkgdir}/usr/share/pixmaps/aether.png"
               install -Dm644 README.md "${pkgdir}/usr/share/doc/aether/README.md"
           }

.github/workflows/release.yml

@@ -71,6 +71,7 @@ jobs:
           cp "build/bin/aether-linux-${ARCH}" "${PKG_DIR}/usr/bin/aether"
           chmod 755 "${PKG_DIR}/usr/bin/aether"
           cp build/linux/aether.desktop "${PKG_DIR}/usr/share/applications/"
+          cp li.oever.aether.url-handler.desktop "${PKG_DIR}/usr/share/applications/"
           cp icon.png "${PKG_DIR}/usr/share/pixmaps/aether.png"
 
           cat > "${PKG_DIR}/DEBIAN/control" <<'CTRL'

README.md

@@ -123,6 +123,7 @@ wails build
 | [Custom Apps](docs/custom-apps.md) | Per-app template system |
 | [File System](docs/filesystem.md) | Where Aether stores files |
 | [Remote Control](docs/remote-control.md) | IPC commands and AI integration |
+| [Protocol Handler](docs/protocol-handler.md) | Register `aether://` links |
 | [Quickshell Widgets](docs/quickshell.md) | QML widgets for Hyprland-style bars |
 | [Standalone](docs/standalone.md) | Using Aether without Omarchy |
 | [Troubleshooting](docs/troubleshooting.md) | Common issues |

docs/protocol-handler.md

@@ -0,0 +1,52 @@
+# Register the aether:// protocol
+
+Use `aether://` links to open a theme, palette, or wallpaper in Aether directly from a browser.
+
+## Quick start
+
+Packages that include `li.oever.aether.url-handler.desktop` make the handler available to the desktop environment. Verify it after installing Aether:
+
+```bash
+xdg-mime query default x-scheme-handler/aether
+```
+
+The expected result is:
+
+```text
+li.oever.aether.url-handler.desktop
+```
+
+If the command prints nothing, register the handler for the current user:
+
+```bash
+mkdir -p ~/.local/share/applications
+install -m 644 li.oever.aether.url-handler.desktop ~/.local/share/applications/
+update-desktop-database ~/.local/share/applications
+xdg-mime default li.oever.aether.url-handler.desktop x-scheme-handler/aether
+```
+
+Run those commands from the Aether source checkout. `make install` already performs these steps.
+
+## Package releases
+
+Linux packages must install the handler desktop file at:
+
+```text
+/usr/share/applications/li.oever.aether.url-handler.desktop
+```
+
+The file declares `MimeType=x-scheme-handler/aether;` and invokes:
+
+```text
+aether --handle-url %u
+```
+
+After installing a new package, users can set it as their default handler with:
+
+```bash
+xdg-mime default li.oever.aether.url-handler.desktop x-scheme-handler/aether
+```
+
+## Troubleshooting
+
+If the handler is installed but links still do not open, rerun the desktop database update and default-association command above. Some browsers cache protocol-handler choices, so restart the browser after changing the association. See [Web Handler](web-handler.md) for supported link parameters and security guidance.