AppImage Integrator is a Linux desktop tool for creating and maintaining local
AppImage integrations. It inspects AppImages, extracts metadata and icons,
creates .desktop launchers, and keeps installed entries repairable and
updatable.
- Install AppImages into a managed library under
~/Applications - Generate and validate local
.desktoplaunchers - Extract embedded icons and metadata from AppImages
- Track installed entries for repair, reinstall, and update flows
- Use the same backend from the GUI and CLI
- Linux
- Python 3.10+
- GTK 4 and Libadwaita runtime packages
python3-gobjectavailable in the Python environment
On Ubuntu/Debian:
sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-4.0 gir1.2-adw-1On Fedora:
sudo dnf install python3-gobject gtk4 libadwaitaOn Arch Linux:
sudo pacman -S python-gobject gtk4 libadwaitaCreate a uv-managed virtual environment with access to system site-packages, then install the project with the development tools:
uv venv --system-site-packages .venv
uv sync --extra devThe --system-site-packages flag is required so the environment can see
distribution-provided GTK/PyGObject packages such as python3-gobject.
If you need a pip-compatible fallback, use:
python3 -m venv --system-site-packages .venv
source .venv/bin/activate
pip install -r requirements.txtBoth approaches install the project in editable mode with the development tools.
They do not replace the required system packages such as GTK 4, Libadwaita, and
python3-gobject.
Run the GUI:
appimage-integratorRun the CLI:
appimage-integrator inspect /path/to/App.AppImage --trust
appimage-integrator install /path/to/App.AppImage --trust --preset disable_gpu
appimage-integrator list
appimage-integrator details <internal-id>
appimage-integrator repair <internal-id>
appimage-integrator reinstall <internal-id>
appimage-integrator uninstall <internal-id>Run from the repository without installing:
PYTHONPATH=src python3 -m appimage_integratorRun checks:
uv run pytest
uv run ruff check src tests