▶ FIELD MANUAL // TOOLS N TOYS

# APPIMAGE QUICK REFERENCE

Essential Commands and Templates

## Basic Operations

BASH

    chmod +x app-name.AppImage
    ./app-name.AppImage

## Proper Installation

### Manual Method

BASH

    mkdir -p ~/Applications
    mv ~/Downloads/app-name.AppImage ~/Applications/
    chmod +x ~/Applications/app-name.AppImage
    nano ~/.local/share/applications/app-name.desktop

## Extract Icon from AppImage

BASH

    ./app-name.AppImage --appimage-extract
    find squashfs-root -name "*.png" | grep -i icon
    cp squashfs-root/path/to/icon.png ~/Applications/app-icon.png
    rm -rf squashfs-root

## Update AppImage

BASH

    mv ~/Applications/app-name.AppImage ~/Applications/app-name.AppImage.old
    mv ~/Downloads/app-name-new.AppImage ~/Applications/app-name.AppImage
    chmod +x ~/Applications/app-name.AppImage
    rm ~/Applications/app-name.AppImage.old

## Remove AppImage

BASH

    rm ~/Applications/app-name.AppImage
    rm ~/Applications/app-icon.png
    rm ~/.local/share/applications/app-name.desktop
    update-desktop-database ~/.local/share/applications/

## Troubleshooting

FUSE Error
`sudo apt install fuse libfuse2`
Validation
`desktop-file-validate ~/.local/share/applications/app-name.desktop`

## Desktop Entry Template

INI

    [Desktop Entry]
    Type=Application
    Name=App Name
    Exec=/home/jl-kruger/Applications/app-name.AppImage
    Icon=/home/jl-kruger/Applications/app-icon.png
    Terminal=false
    Categories=Utility;

## Common AppImage Commands

UTILITIES

    ./app-name.AppImage --appimage-help
    ./app-name.AppImage --appimage-version
    ./app-name.AppImage --appimage-extract
    gtk-launch app-name

## Categories Reference

- AudioVideo, Development, Education, Game, Graphics
- Network, Office, Science, Settings, System, Utility

## Find Installed AppImages

    ls -lh ~/Applications/*.AppImage
    ls ~/.local/share/applications/*.desktop

## Pro Tips

Aliases
`alias myapp='~/Applications/app-name.AppImage'`

## Security Check

    sha256sum app-name.AppImage
    file app-name.AppImage