FLATPAK-REMOTE-LS(1)

💖 FLATPAK-REMOTE-LS 💖

okay bestie, so this is the flatpak remote-ls manual page, and it is literally the "what's even available in here??" command. stay with me, it's so good.

---

✨ NAME ✨

flatpak-remote-ls — Show available runtimes and applications

---

🌸 SYNOPSIS 🌸

flatpak remote-ls [OPTION...] [REMOTE]

---

🦋 DESCRIPTION 🦋

So like. This shows you the runtimes and applications that are available in the remote repository called REMOTE. If you don't specify a REMOTE, it just shows you all of them, every remote, no filter, the whole vibe. 🫶

And if you're sitting there like "girl what remotes do I even have", that's what flatpak remotes is for — go find all your configured remote repositories there.

REMOTE doesn't have to be a name either! It can be a file:// URI pointing to a local repository instead of a remote name. iconic.

Unless you override it with --system, --user, or --installation, this command uses either the default system-wide installation or the per-user one — whichever one actually has the specified REMOTE. it picks for you, it's very smart.

---

🎀 OPTIONS 🎀

here's everything it understands, no skipping, we're doing all of them:

• -h, --help — shows the help options and dips. ✨
• -u, --user — use the per-user configuration.
• --system — use the default system-wide configuration.
• --installation=NAME — use a system-wide installation specified by NAME, picked from the ones defined in /etc/flatpak/installations.d/. and listen: --installation=default is equivalent to using --system. same thing, different outfit.
• --cached — prefers locally cached info if it can, even though it may be out of date. it's faster, yes, but it risks returning stale information. speed vs accuracy, the eternal struggle. 💀
• -d, --show-details — shows arches, branches and commit ids, on top of the names. equivalent to --columns=all.
• --runtime — show only runtimes, omit applications.
• --app — show only applications, omit runtimes.
• --all, -a — show everything. by default, locale and debug extensions, plus secondary arches when the primary arch is available, are hidden. so this is the "no secrets" mode. 👑
• --updates — show only the ones that have updates available.
• --arch=ARCH — show only those matching the specified architecture. by default only supported architectures show up. use --arch=* to show all architectures. and for what the host actually supports, see flatpak --supported-arches.
• -v, --verbose — prints debug information while the command is processing.
• --ostree-verbose — prints OSTree debug information while the command is processing.
• --app-runtime=RUNTIME — lists applications that use the given runtime.
• --columns=FIELD,... — tells it what information to show about each ref. you can list multiple fields, or use this option multiple times, your call bestie.
  • append :s[tart], :m[iddle], :e[nd] or :f[ull] to column names to change ellipsization. yes that's a real word and yes it matters.

---

🧚 FIELDS 🧚

these are the fields the --columns option understands:

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

ngl, a cute little detail: field names can be abbreviated to a unique prefix. so you can be lazy and it still works. 💅

---

🌈 EXAMPLES 🌈

first one, using the user install and only apps from testrepo:

$ flatpak --user remote-ls --app testrepo

    Ref
    org.gnome.Builder
    org.freedesktop.glxgears

second one, just straight up listing everything:

$ flatpak remote-ls
file:///run/media/mwleeds/d4d37026-cde2-4e5e-8bcc-d23ebbf231f9/.ostree/repo

    Ref
    org.kde.Khangman

---

👑 SEE ALSO 👑

flatpak(1), flatpak-remotes(1)

---

and that's the whole page bestie, you ate it. 🍓 this one's from the flatpak manual, FLATPAK REMOTE-LS(1) — go forth and remote-ls responsibly. mwah. 💖✨