README: Wayland window icon needs the desktop entry; --install-desktop for unpackaged builds (Tim t1026u)

Authored 2026-11-07 · 6 days ago

Hash: 69fd4f05393bb6d2a187ed978636e3d6eadda6c5
Parent: 6f638f30

1 file changed +1 −1

README.md +1 −1

@@ -207,7 +207,7 @@ A pushed `vX.Y.Z` tag (protected pattern `v*`) runs the tag pipeline: tests, the

207 207

- **Debian/Arch:** the packages install the `.ppd` MIME association, desktop launcher and icons. Choose the editor in **Open with**.

208 208

- **Linux AppImage/plain binary:** keep the file in its permanent location and run `"/path/Paperdoll.AppImage" --install-desktop`. This needs `shared-mime-info` and `desktop-file-utils`. The editor then appears in **Open with**. Repeat after moving the AppImage.

209 209

210

The window, the Linux launcher and the Windows executable use Tim's application icon. The window has app id `paperdoll-renderer` (equal to `paperdoll-renderer.desktop` and `StartupWMClass`), so KDE and GNOME under Wayland map the window to the launcher and icon; the app runs natively under Wayland and via X11 under X11. Under Wayland the icon only appears once the desktop file is installed (package, or file association from the app).

210

The window, the Linux launcher and the Windows executable use Tim's application icon. The window has app id `paperdoll-renderer` (equal to `paperdoll-renderer.desktop` and `StartupWMClass`), so KDE and GNOME under Wayland map the window to the launcher and icon; the app runs natively under Wayland and via X11 under X11. Under Wayland a program cannot send its own window icon, so the desktop takes the icon from the installed `paperdoll-renderer.desktop`. With the AUR, Arch or Debian package this works out of the box. A binary run without a package (a `cargo build` in `target/release`, the AppImage or an unpacked copy) shows the generic Wayland icon until you run it once with `--install-desktop`. Restart the editor after that.

211 211

212 212 ## Attribution

213 213

@@ -207,7 +207,7 @@ A pushed `vX.Y.Z` tag (protected pattern `v*`) runs the tag pipeline: tests, the

207

- **Debian/Arch:** the packages install the `.ppd` MIME association, desktop launcher and icons. Choose the editor in **Open with**.

207

- **Debian/Arch:** the packages install the `.ppd` MIME association, desktop launcher and icons. Choose the editor in **Open with**.

208

- **Linux AppImage/plain binary:** keep the file in its permanent location and run `"/path/Paperdoll.AppImage" --install-desktop`. This needs `shared-mime-info` and `desktop-file-utils`. The editor then appears in **Open with**. Repeat after moving the AppImage.

208

- **Linux AppImage/plain binary:** keep the file in its permanent location and run `"/path/Paperdoll.AppImage" --install-desktop`. This needs `shared-mime-info` and `desktop-file-utils`. The editor then appears in **Open with**. Repeat after moving the AppImage.

209

210

The window, the Linux launcher and the Windows executable use Tim's application icon. The window has app id `paperdoll-renderer` (equal to `paperdoll-renderer.desktop` and `StartupWMClass`), so KDE and GNOME under Wayland map the window to the launcher and icon; the app runs natively under Wayland and via X11 under X11. Under Wayland the icon only appears once the desktop file is installed (package, or file association from the app).

210

The window, the Linux launcher and the Windows executable use Tim's application icon. The window has app id `paperdoll-renderer` (equal to `paperdoll-renderer.desktop` and `StartupWMClass`), so KDE and GNOME under Wayland map the window to the launcher and icon; the app runs natively under Wayland and via X11 under X11. Under Wayland a program cannot send its own window icon, so the desktop takes the icon from the installed `paperdoll-renderer.desktop`. With the AUR, Arch or Debian package this works out of the box. A binary run without a package (a `cargo build` in `target/release`, the AppImage or an unpacked copy) shows the generic Wayland icon until you run it once with `--install-desktop`. Restart the editor after that.

211

212## Attribution

213