Repository files navigation

Creates AppImages from AppDirs. For use withlinuxdeploy.

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 theofficial 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 therelease 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 tothe documentation.

linuxdeploy-plugin-appimage can be configured using environment variables.

• LDAI_UPDATE_INFORMATION="...": embedupdate information in the AppImage, and generate corresponding.zsync file
• LDAI_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 AppImage
• LDAI_SIGN_KEY=key_id: GPG Key ID to use for signing. This environment variable is only used ifSIGN is set.
• LDAI_VERBOSE=1: set this variable to any value to enable verbose output
• LDAI_OUTPUT=filename: change filename of resulting AppImage
• LDAI_RUNTIME_FILE: path to custom AppImage runtime appimagetool should use
• LDAI_NO_APPSTREAM=1: skip checking AppStream metadata for issues
• LDAI_COMP=...: compression algorithm appimagetool/mksquashfs should use (e.g.,xz,gzip), seeappimagetool's repository for more information
• LINUXDEPLOY_OUTPUT_APP_NAME: setsAPPIMAGETOOL_APP_NAME to configure appimagetool's autogenerated filename prefix
• LINUXDEPLOY_OUTPUT_VERSION orLDAI_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)