Create desktop entries for AppImages from upstream AppImage metadata.

./appimage-desktop-entry.sh install /path/to/App.AppImage
./appimage-desktop-entry.sh list
./appimage-desktop-entry.sh remove org.example.App

• extracts AppImage with --appimage-extract
• requires exactly one root .desktop file in extracted AppDir
• reuses upstream desktop metadata
• rewrites only Exec, TryExec, Icon, plus management X-AppImage-* keys
• copies icon to ~/.local/share/appimage-desktop-entry/icons/
• writes launcher to ~/.local/share/applications/<desktop-id>.desktop
• validates generated desktop file with desktop-file-validate when available
• refreshes desktop database with update-desktop-database when available

Icon resolution order:

1. squashfs-root/.DirIcon
2. root file matching upstream Icon= basename
3. file under usr/share/icons/** matching upstream Icon= basename
4. root image fallback only when exactly one valid image exists

Formats: PNG preferred, SVG fallback, XPM last.

Lists only entries managed by this script.

Output format:

<desktop-id> | <name> | <version> | <source-appimage-path>

Removes only desktop integration:

• ~/.local/share/applications/<desktop-id>.desktop
• managed icon file recorded in desktop metadata

Does not delete source AppImage.

Installed launchers include:

• X-AppImage-ManagedBy=appimage-desktop-entry
• X-AppImage-SourcePath=<absolute AppImage path>
• X-AppImage-DesktopId=<desktop-id>
• X-AppImage-IconPath=<absolute managed icon path>

When available from upstream metadata:

• X-AppImage-Name
• X-AppImage-Version
• X-AppImage-Arch

Optional but recommended:

• desktop-file-utils

Provides:

• desktop-file-validate
• update-desktop-database

Target behavior:

• Ubuntu 20.04
• Ubuntu 22.04
• Ubuntu 24.04
• likely Ubuntu 26.04 once tested there