Skip to content

Commit 4690c61

Browse files
authored
Extend spec to give any app icons in usr/share/icons preference
Draft for approaching #19 (as well as #16): * mention icon files below `usr/share/icons/hicolor` to be taken into account preferred if present * use $APPICON as variable name for the application icon identifier, to remove the otherwise unneeded expectation for being the same string as used for the basename of the desktop file name (the `Icon=` would be unneeded otherwise)
1 parent 35c50ec commit 4690c61

1 file changed

Lines changed: 2 additions & 1 deletion

File tree

draft.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,7 +143,8 @@ An [AppImage] which conforms to the type 2 image format:
143143
* **MUST** contain a file named `AppRun` in its root directory
144144
* **SHOULD** contain a [payload application] that is ultimately executed when the [AppImage] is executed
145145
* **SHOULD** contain exactly one `$APPNAME.desktop` file in its root directory with `$APPNAME` being the name of the [payload application]
146-
* **MAY** contain an `$APPNAME.png` file in its root directory with `$APPNAME` being the name of the [payload application] as set in the `Icon=` key of the `$APPNAME.desktop` file. If present, this icon **SHOULD** be given preference as the icon being used to represent the [AppImage]. The icon **SHOULD** be a PNG with 256x256 or 512x512 pixels
146+
* **MAY** contain icon files below `usr/share/icons/hicolor` following the [Icon Theme Specification](https://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html) for the icon identifier as set in the `Icon=` key of the `$APPNAME.desktop` file. If present, these icon files **SHOULD** be given preference as the icon being used to represent the [AppImage].
147+
* **MAY** contain an `$APPICON.svg`, `$APPICON.svgz` or `$APPICON.png` file in its root directory with `$APPICON` being the icon identifier as set in the `Icon=` key of the `$APPNAME.desktop` file. If present and no icon files matching the icon identifier present below `usr/share/icons/hicolor`, this icon **SHOULD** be given preference as the icon being used to represent the [AppImage]. If a PNG file, the icon **SHOULD** be of size 256x256, 512x512, ot 1024x1024 pixels.
147148
* **SHOULD** contain a `.DirIcon` file as per the [AppDir] specification
148149

149150
#### The `AppRun` file:

0 commit comments

Comments
 (0)