manapak is a desktop application for checking and applying Flatpak updates through the Flatpak Python API (gi.repository.Flatpak).
- list installed Flatpak applications
- check which installed apps have updates available
- update selected apps with
Flatpak.Transaction - operate in the background without blocking the main UI thread
- show Flatpak errors through dialogs if any
manapak relies on the Flatpak Python bindings and the Flatpak daemon. For user installs, no extra privileges are usually needed.
For system installs, Flatpak authorization is typically handled by the operating system's PolicyKit/Polkit mechanism. manapak does not call pkexec or other shell-based escalators directly. When Flatpak raises a permission-related GLib.Error, the app converts it into a user-facing message and asks the user to authenticate when the system requests it.
This keeps the application safe and backend-agnostic while still allowing system-wide updates when the user grants the required authorization.
The manapak icon is original project artwork released under CC0-1.0. It is not the Flatpak logo and does not imply endorsement by the Flatpak project. Details are recorded in NOTICE.
Runtime requirements:
- Python 3.9 or newer
python-manatools>= 0.99.4 with a GTK, Qt or ncurses backend- PyGObject
- Flatpak GObject Introspection typelib (
gir1.2-flatpak-1.0or the distribution equivalent)
Development requirements:
- Poetry /
poetry-core - pytest
- gettext tools (
xgettext,msgfmt,msginit,msgmerge) rsvg-convertto regenerate PNG application icons
poetry installThe package installs the manapak command, desktop entry and hicolor icons.
python -m manapak --helpor, from the project root:
PYTHONPATH=. python -m manapakEnable logs:
python -m manapak --logging
python -m manapak --log-file /tmp/manapak.log --debugSelect a UI backend:
python -m manapak --gtk
python -m manapak --qt
python -m manapak --ncursesThe bottom action row provides Help and About dialogs. Application metadata, the SVG
logo and project links are registered with the active manatools.aui backend.
Translation sources live in po/. Compile them locally with:
python tools/po_build.py
python -m manapak --locales-dir "$PWD/share/locale"See CONTRIBUTING.md for catalog extraction/update commands and the full development workflow.