▶ 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