appimage-manager — auto-detect, symlink, and launcher integration for AppImages

[pvojnisek]

I wrote a single-file Python tool that automatically makes AppImages show up in the application launcher with proper icons.

The problem: Every time I downloaded an AppImage, I had to manually create a .desktop file and find/set the icon. With 27+ AppImages, this got old fast.

What it does:

• Scans a directory for .AppImage files
• Extracts icons, categories, and StartupWMClass from inside the AppImage
• Installs icons to the XDG hicolor theme (~/.local/share/icons/hicolor/)
• Generates .desktop files with proper categories and dock support
• Creates version-agnostic symlinks (e.g., obsidian.AppImage → Obsidian-1.9.10.AppImage)
• CSV registry for tracking — user-editable labels, categories, status
• Optional systemd watcher for auto-detection when new AppImages are dropped in

What it doesn't do: It doesn't download, update, or manage AppImage versions. It just makes your existing AppImages visible in the launcher. One job, done well.

Zero dependencies — pure Python 3.9+ stdlib. Single file, ~730 lines, MIT licensed.

Works on COSMIC, GNOME, KDE, and any freedesktop-compliant desktop.

🔗 https://github.com/pvojnisek/appimage-manager

Happy to hear feedback — especially if the name extraction regex misses your AppImage naming convention!