FLATPAK-LIST(1)

💖 FLATPAK LIST(1) 💖

okay bestie, welcome to flatpak-list — the part of the flatpak manual that tells you how to see what's already on your machine. let's get into it 🫶

---

✨ NAME ✨

flatpak-list — list installed applications and/or runtimes 🌸

---

✨ SYNOPSIS ✨

flatpak list [OPTION...]

---

✨ DESCRIPTION ✨

So basically? It lists the names of the installed applications and runtimes. that's it. that's the whole vibe. 👑

By default, both apps and runtimes show up, but you can change that with the --app or --runtime options. pick your fighter 💅

By default, both per-user and system-wide installations are shown. Use the --user, --installation or --system options if you want to switch that up.

Also — and this is the lowkey underrated part — the list command can find installed apps that use a certain runtime, using the --app-runtime option. iykyk ✨

---

✨ OPTIONS ✨

here's everything this command understands:

• -h, --help — shows the help options and dips. bye! 👋
• -u, --user — lists per-user installations.
• --system — lists the default system-wide installations.
• --installation=NAME — lists a system-wide installation specified by NAME, picked from the ones defined in /etc/flatpak/installations.d/. and heads up: using --installation=default is the same thing as using --system 🎀
• --arch=ARCH — lists apps/runtimes for this architecture. check flatpak --supported-arches to see which architectures your host actually supports.
• -d, --show-details — shows origin, sizes and other extra info. it's equivalent to --columns=all. the glow-up version 💅
• --app — lists applications.
• --runtime — lists runtimes.
• --all, -a — lists all installed runtimes, including locale and debug extensions. these are hidden by default, so this is the little peek-behind-the-curtain moment 🦋
• --app-runtime=RUNTIME — lists applications that use the given RUNTIME.
• -v, --verbose — prints debug information while the command is processing.
• --ostree-verbose — prints OSTree debug information while the command is processing.
• --columns=FIELD,... — specifies what information to show about each ref. you can list multiple fields, or use this option multiple times. 🍓

Append :s[tart], :m[iddle], :e[nd] or :f[ull] to column names to change ellipsization.

---

✨ FIELDS ✨

these are the fields the --columns option understands:

• name — show the name
• description — show the description
• application — show the application or runtime ID
• arch — show the architecture
• branch — show the branch
• runtime — show the used runtime
• version — show the version
• ref — show the ref
• origin — show the origin remote
• installation — show the installation
• active — show the active commit
• latest — show the latest commit
• size — show the installed size
• options — show options
• all — show all columns
• help — show the list of available columns

ngl, this one's a lifesaver: field names can be abbreviated to a unique prefix. so you don't have to type the whole thing, just enough that nothing else matches 💜

---

✨ EXAMPLES ✨

$ flatpak --user --columns=app list

    Application
    org.gnome.Builder
    org.freedesktop.glxgears
    org.gnome.MyApp
    org.gnome.gedit

look at that list. immaculate. 🌈

---

✨ SEE ALSO ✨

flatpak(1), flatpak-install(1), flatpak-update(1)

---

and that's the whole page bestie, no cap 💖 this one came straight out of the flatpak manual — the FLATPAK LIST(1) page, to be exact. go list something iconic. periodt 👑✨