Creates AppImages from AppDirs. For use with linuxdeploy.
As this software is concepted as a plugin for linuxdeploy, it is recommended to use it as such.
When calling linuxdeploy, just add --output appimage
to enable the plugin. After completing the bundling process and running e.g., input plugins, linuxdeploy will then call the AppImage plugin to create an AppImage from the AppDir.
For more information, see the official AppImage packaging guide.
Like all linuxdeploy plugins, linuxdeploy-plugin-appimage is a standalone tool and can be used without linuxdeploy.
Please see the --help
test for more information.
The official linuxdeploy AppImage ships with a fairly recent version of the plugin. You can at any time still download the AppImage from the release page, and put it into the same directory as linuxdeploy. Then, linuxdeploy will use the AppImage instead of the bundled version.
For more information on how linuxdeploy's plugin system works, please refer to the documentation.
linuxdeploy-plugin-appimage can be configured using environment variables.
LDAI_UPDATE_INFORMATION="..."
: embed update information in the AppImage, and generate corresponding .zsync
fileLDAI_GUESS_UPDATE_INFORMATION
: make appimagetool try to guess some update information (may or may not work, requires specific workflow and setup)LDAI_SIGN=1
: set this variable to any value to enable signing of the AppImageLDAI_SIGN_KEY=key_id
: GPG Key ID to use for signing. This environment variable is only used if SIGN
is set.LDAI_VERBOSE=1
: set this variable to any value to enable verbose outputLDAI_OUTPUT=filename
: change filename of resulting AppImageLDAI_RUNTIME_FILE
: path to custom AppImage runtime appimagetool should useLDAI_NO_APPSTREAM=1
: skip checking AppStream metadata for issuesLDAI_COMP=...
: compression algorithm appimagetool/mksquashfs should use (e.g., xz
, gzip
), see appimagetool's repository for more informationLINUXDEPLOY_OUTPUT_APP_NAME
: sets APPIMAGETOOL_APP_NAME
to configure appimagetool's autogenerated filename prefixLINUXDEPLOY_OUTPUT_VERSION
or LDAI_VERSION
: version number to pass to appimagetool (will be included in the root desktop file to be picked up by desktop integration tools and, if $LDAI_OUTPUT
is not set, will be included in appimagetool's autogenerated output filename)