How to Create a PKGBUILD for a AppImage binary

Posted on November 7, 2019

On Arch Linux PKGBUILD scripts can be used to help manage installing and updating AppImage software releases.

AppImage PKGBUILD Template

Using the following template it should be easy to create your own PKGBUILD script from an AppImage posted on public site like Github.

To use the PKGBUILD run makepkg to build a my-project-appimage-0.0.1-1-x86_64.pkg.tar.xz. Then the package can be installed with pacman -U my-project-appimage-0.0.1-1-x86_64.pkg.tar.xz. The AppImage can then be started by running my-project-appimage on the command line to start the appimage.

When there is a new release for the AppImage, the version, AppImage source location and sha256 hash can be updated, rebuilt and reinstalled.

NOTE: See new post on improving upon this template for better GUI integration.

# Maintainer: My Name <>

pkgdesc="Description of my project"

package() {
    install -Dm755 "${srcdir}/${pkgname}-${pkgver}.AppImage" "${pkgdir}/opt/${pkgname}/${pkgname}.AppImage"
    install -Dm644 "${srcdir}/LICENSE" "${pkgdir}/opt/${pkgname}/LICENSE"

    # Symlink executable
    mkdir -p "${pkgdir}/usr/bin"
    ln -s "/opt/${pkgname}/${pkgname}.AppImage" "${pkgdir}/usr/bin/${pkgname}"

    # Symlink license
    mkdir -p "${pkgdir}/usr/share/licenses/$pkgname"
    ln -s "/opt/$pkgname/LICENSE" "$pkgdir/usr/share/licenses/$pkgname"


AppImages are already easy to install and run as noted in this StackOverflow answer. You could just copy the appimage to /usr/local/bin and make it executable with a chmod +x /usr/local/bin/my-project.AppImage so you could run it from the command line. When updating, just replace the AppImage file with the new version. Many AppImage applications notify the user when an update is available.

This does require each AppImage is updated independently and the user will only know when the application notifies them of an update.

A framework for managing many updates

Using an AUR helper all the AppImages can be updated automatically, just like other packages on Arch Linux. For this reason, I will usually go ahead and upload my PKGBUILD to the AUR if one doesn’t already exist. Others can then take advantage of the script I have already created. See my guide to maintaining PKGBUILDs on the AUR.

Desktop Launcher

My template doesn’t install a desktop launcher because when running the AppImage for the first time, it will prompt the user for installing the desktop launcher. On the first run, the user will need to launch the application from the command line. From then on, the AppImage application will be available where the other desktop applications are, if the user selected to install the desktop launcher.

Modified: November 17, 2019 - 07:10:39 PM