FLATPAK-PS(1)

✨ FLATPAK PS ✨

okay bestie, welcome to flatpak-ps 💅 this is the Enumerate running instances page from the flatpak ps corner of the flatpak(1) manual, and yes we are gonna read the whole thing together, no skimming 🫶

---

🌸 SYNOPSIS 🌸

flatpak ps [OPTION...]

that's it. that's the whole vibe. options only, no positional args, she's low maintenance 💖

---

🦋 DESCRIPTION 🦋

She lists useful information about running Flatpak instances. That's the whole job. Iconic, honestly.

And okay, if you want the full details of a running instance — like, the whole tea — you can just open this file:

/run/user/$UID/.flatpak/$INSTANCE/info

where $INSTANCE is the instance ID that flatpak ps reported to you in the first place. So flatpak ps tells you the name, and the info file spills everything else 🔥

---

💅 OPTIONS 💅

here's what she understands, bestie:

• -h, --help — shows the help options and then dips. exit, stage left 🎀
• -v, --verbose — prints debug information while the command is doing its thing. she's yapping but it's useful yapping ✨
• --ostree-verbose — prints OSTree debug information during command processing. even more yapping. deep lore 🧚
• --columns=FIELD,... — tell her exactly what information to show about each instance. You can list multiple fields, or just use this option multiple times, your call, she's flexible 💜

You can also append :s[tart], :m[iddle], :e[nd] or :f[ull] to column names to change the ellipsization. yes that's a real word. yes it matters. it controls where the text gets chopped off when it's too long 🌈

---

👑 FIELDS 👑

These are the fields that the --columns option understands, and honestly the range is giving:

• instance — Show the instance ID
• application — Show the application ID
• arch — Show the architecture
• branch — Show the application branch
• commit — Show the application commit
• runtime — Show the runtime ID
• runtime-branch — Show the runtime branch
• runtime-commit — Show the runtime commit
• pid — Show the PID of the wrapper process
• child-pid — Show the PID of the sandbox process
• active — Show whether the app is active (i.e. has an active window)
• background — Show whether the app is in the background (with no open windows)
• all — Show all columns
• help — Show the list of available columns

📌 heads up: field names can be abbreviated to a unique prefix. So like, shorten them, but only as far as they stay unambiguous, okay? don't be out here causing chaos 🙈

---

🍓 EXAMPLES 🍓

look at her go:

$ flatpak ps --columns=application,pid,runtime,runtime-branch

picking exactly the columns she wants. main character energy, no notes 💖

---

🔥 SEE ALSO 🔥

• flatpak(1)
• flatpak-run(1)

---

and that's the whole page bestie, you ate that 🫶 this was FLATPAK PS(1) from the flatpak manual — section 1, the classic — so go forth, run flatpak ps, and check your instances like the icon you are. periodt 💅✨👑