Skip to content

docs: explain systemd desktop detection - #33

Open
TyceHerrman wants to merge 1 commit into
Colonial-Dev:masterfrom
TyceHerrman:docs/27-xdg-current-desktop
Open

docs: explain systemd desktop detection#33
TyceHerrman wants to merge 1 commit into
Colonial-Dev:masterfrom
TyceHerrman:docs/27-xdg-current-desktop

Conversation

@TyceHerrman

Copy link
Copy Markdown

Summary

Document how Satpaper uses XDG_CURRENT_DESKTOP when selecting its built-in Linux wallpaper handler, especially when it runs as a systemd user service.

Changes

  • list the exact XDG_CURRENT_DESKTOP values recognized for GNOME, Ubuntu GNOME, and KDE
  • show how to inspect the value from a graphical-session terminal
  • explain how to pass an inherited supported value to a systemd user unit and restart it
  • clarify that unsupported desktops such as Cinnamon should use --wallpaper-command/SATPAPER_WALLPAPER_COMMAND instead of claiming GNOME or KDE
  • note that a custom wallpaper command bypasses desktop detection

Testing

  • documentation-only review against the current desktop-detection behavior
  • git diff --check

Closes #27

@TyceHerrman
TyceHerrman marked this pull request as ready for review July 17, 2026 01:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

XDG_CURRENT_DESKTOP Environmental Variable Documentation

1 participant