singular-particular-space/DumperCan/appimage-quick-reference.md

AppImage Quick Reference Card

🚀 Basic Operations

Download and Run (Quick Test)

# Make executable
chmod +x app-name.AppImage

# Run it
./app-name.AppImage

---

🏠 Proper Installation

Using the Automated Script

# Simple - script will prompt for details
bash install-appimage.sh ~/Downloads/app-name.AppImage

# With all options
bash install-appimage.sh ~/Downloads/app-name.AppImage my-app-name Office

Manual Installation

# 1. Move to Applications
mkdir -p ~/Applications
mv ~/Downloads/app-name.AppImage ~/Applications/
chmod +x ~/Applications/app-name.AppImage

# 2. Create desktop entry
nano ~/.local/share/applications/app-name.desktop

# 3. Paste this template (edit as needed):
[Desktop Entry]
Type=Application
Name=App Name
Comment=Brief description
Icon=/home/jl-kruger/Applications/app-icon.png
Exec=/home/jl-kruger/Applications/app-name.AppImage
Terminal=false
Categories=Utility;

# 4. Update database
chmod +x ~/.local/share/applications/app-name.desktop
update-desktop-database ~/.local/share/applications/

---

🎨 Extract Icon from AppImage

# Extract AppImage contents
./app-name.AppImage --appimage-extract

# Find icon
find squashfs-root -name "*.png" | grep -i icon

# Copy icon
cp squashfs-root/path/to/icon.png ~/Applications/app-icon.png

# Clean up
rm -rf squashfs-root

---

🔄 Update AppImage

# 1. Download new version
cd ~/Downloads

# 2. Backup current version
mv ~/Applications/app-name.AppImage ~/Applications/app-name.AppImage.old

# 3. Install new version
mv ~/Downloads/app-name-new.AppImage ~/Applications/app-name.AppImage
chmod +x ~/Applications/app-name.AppImage

# 4. Test
~/Applications/app-name.AppImage

# 5. Remove backup once confirmed
rm ~/Applications/app-name.AppImage.old

---

🗑️ Remove AppImage

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

# Also remove app data (if exists)
rm -rf ~/.config/app-name
rm -rf ~/.local/share/app-name

---

🔧 Troubleshooting

Permission Denied

chmod +x app-name.AppImage

FUSE Error

# Install FUSE
sudo apt install fuse libfuse2

# Or run without FUSE
./app-name.AppImage --appimage-extract
./squashfs-root/AppRun

Desktop Entry Not Appearing

# Validate
desktop-file-validate ~/.local/share/applications/app-name.desktop

# Update database
update-desktop-database ~/.local/share/applications/

# Restart panel
xfce4-panel -r

Missing Libraries

# Check what's missing
ldd app-name.AppImage

# Install common deps
sudo apt install libfuse2 libgl1 libxcb1

---

📝 Desktop Entry Template

Basic

[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;

With Multiple Actions

[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=Development;
Actions=SafeMode;Debug;

[Desktop Action SafeMode]
Name=Safe Mode
Exec=/home/jl-kruger/Applications/app-name.AppImage --safe-mode

[Desktop Action Debug]
Name=Debug Mode
Exec=/home/jl-kruger/Applications/app-name.AppImage --debug

---

📁 Recommended Directory Structure

~/Applications/
  ├── app1.AppImage
  ├── app1-icon.png
  ├── app2.AppImage
  ├── app2-icon.png
  └── README.md           # Document what's installed

~/.local/share/applications/
  ├── app1.desktop
  └── app2.desktop

---

🎯 Common AppImage Commands

# Get help (if supported)
./app-name.AppImage --appimage-help

# Get version
./app-name.AppImage --appimage-version

# Extract contents
./app-name.AppImage --appimage-extract

# Self-integrate (if supported)
./app-name.AppImage --appimage-integrate

# Check file type
file app-name.AppImage
# Should show: ELF 64-bit LSB executable

# Test launch from desktop entry
gtk-launch app-name

# Check size
du -h app-name.AppImage

---

📊 Categories Reference

Common categories for desktop entries:

• AudioVideo - Media players, music apps
• Development - IDEs, text editors, dev tools
• Education - Learning software
• Game - Games
• Graphics - Image editors, viewers, design tools
• Network - Browsers, email, chat
• Office - Word processors, spreadsheets, notes
• Science - Scientific applications
• Settings - Configuration tools
• System - System tools
• Utility - General utilities (default)

Use semicolon to separate multiple:

Categories=Development;TextEditor;Utility;

---

🔍 Find Installed AppImages

# List all AppImages in Applications
ls -lh ~/Applications/*.AppImage

# Find all desktop entries
ls ~/.local/share/applications/*.desktop

# Search for specific app
find ~/Applications -name "*app-name*.AppImage"

# Check which apps are in menu
grep -l "Exec.*AppImage" ~/.local/share/applications/*.desktop

---

💡 Pro Tips

Create Launcher Alias

# Add to ~/.bashrc
alias myapp='~/Applications/app-name.AppImage'

# Use it
myapp

Version in Filename

# Keep track of versions
mv app.AppImage app-v1.2.3.AppImage

# Symlink to latest
ln -s app-v1.2.3.AppImage app.AppImage

# Desktop entry points to symlink
Exec=/home/jl-kruger/Applications/app.AppImage

Batch Install Multiple AppImages

for appimage in ~/Downloads/*.AppImage; do
    bash install-appimage.sh "$appimage"
done

---

🛡️ Security Check

# Verify file type
file app-name.AppImage

# Check if downloaded correctly
sha256sum app-name.AppImage
# Compare with official checksum

# Scan with ClamAV (if installed)
clamscan app-name.AppImage

---

🌐 Where to Find AppImages

1. Project GitHub Releases

   • https://github.com/username/project/releases

2. Official Website

   • Look for "Download for Linux" → AppImage option

3. Verify Source

   • Only download from official sources
   • Check file integrity with checksums

---

📞 Quick Help

# Installation help
bash install-appimage.sh

# Check if working
gtk-launch app-name

# View desktop entry
cat ~/.local/share/applications/app-name.desktop

# Validate desktop entry
desktop-file-validate ~/.local/share/applications/app-name.desktop

---

Cheat Sheet Version: 1.0
For: Linux Mint 22.2 Xfce
Date: October 2025