A shepherd for your Appimages.
update README.md
Aly Raffauf
(Jun 17, 2026, 10:12 PM EDT)
4c6f6eff
012b3866
+5
+5
README.md
+5
README.md
···
13
13
- **Shows up like a real app.** Lands in your application menu with its real name and icon.
14
14
- **Uninstalls cleanly.** Remove an app and its launcher and icon go with it. No leftovers.
15
15
- **Upgrades replace instead of piling up.** appherder names an app by what's inside it, not the download's filename, so a newer version of `Foo` just replaces the old one.
16
+
- **Checks for updates.** Reads the update info baked into each AppImage and fetches the latest from GitHub, GitLab, zsync, or a static URL. `appherder upgrade --check` shows what's new; `appherder upgrade` downloads and installs it.
16
17
- **Won't touch your other apps.** It only removes launchers it made itself, so your Flatpaks, Snaps, and hand-made shortcuts are safe.
17
18
- **Quiet when nothing changed.** Re-installing an unchanged app does nothing. Drop your AppImages in one folder and `appherder sync` lines everything up.
18
19
···
51
52
appherder install ~/Downloads/Foo-x86_64.AppImage # install one
52
53
appherder uninstall foo # remove one
53
54
appherder sync # match your apps to what's in ~/AppImages
55
+
appherder upgrade --check # see what's out of date
56
+
appherder upgrade # download and install updates
54
57
appherder migrate # adopt apps another tool set up
55
58
```
56
59
57
60
Installing copies the AppImage into `~/AppImages`, so you can delete the original download. That folder is the source of truth: add or remove files there and `appherder sync` matches your launchers to it. To uninstall, use the name the file has in `~/AppImages` (without `.appimage`).
61
+
62
+
`appherder upgrade` reads the update info baked into each AppImage and fetches the latest from GitHub, GitLab, zsync, or a static URL. Apps with nothing to check are skipped, downloads are verified when a checksum is available, and apps that are already current are left alone.
58
63
59
64
Coming from another AppImage tool? `appherder migrate` adopts the ones in `~/AppImages` and clears out launchers whose AppImage is gone, leaving everything else alone.
60
65