flatpak

Tags: packages, desktop, flatpak
Secrets needed: No
Runs on: Desktop group only (skip_flatpak: false)

Installs and manages Flatpak applications from Flathub.

What It Does

  1. Fixes broken Flatpak symlinks if present
  2. Adds the Flathub remote
  3. Removes unwanted system flatpaks (Firefox, Thunderbird — replaced by Zen)
  4. Installs missing flatpaks in batch (fast path), falling back to individual installs
  5. Updates all flatpaks when upgrade: true is set
  6. Creates Chromium wrapper scripts for CLI compatibility

Package List

Defined in roles/flatpak/vars/main.yml as system_flatpaks (the Flathub remote is in flatpak_remotes, also set in group_vars/all.yml). Key apps:

AppFlatpak ID
Zen Browserapp.zen_browser.zen
VS Codecom.visualstudio.code
Ungoogled Chromiumcom.github.Eloston.UngoogledChromium
Flatsealcom.github.tchx84.Flatseal
GNOME appsCalculator, Calendar, Clocks, Contacts, Loupe, etc.
Vesktopdev.vencord.Vesktop
Obsidianmd.obsidian.Obsidian

Wrapper Scripts

Creates ~/.local/bin/chromium, ~/.local/bin/google-chrome, and ~/.local/bin/chromium-browser that exec into the Ungoogled Chromium flatpak — tools that hardcode google-chrome or chromium-browser still work.

Notes

  • Installs system-wide (--system) with become: true
  • Batch install tolerates partial failures — individual retries catch stragglers