FLATPAK-SEARCH(1)

📦
version 1.18.4 · 15 versions
, in debian trixie, fedora 44, nixpkgs unstable, ubuntu stonking

💖 FLATPAK-SEARCH(1) 💖

okay bestie, welcome to the flatpak search manual page — this is the one where you go hunting for apps and runtimes, and honestly? it's giving ✨main character energy✨. let's get into it 🫶

🌸 NAME 🌸

flatpak-search — Search for applications and runtimes

no like literally that's the whole job. you search. you find. you slay. 💅

🦋 SYNOPSIS 🦋

flatpak search TEXT

that's it. that's the whole thing. you hand it some TEXT and it goes off looking for matches. iconic behavior honestly 👑

🎀 DESCRIPTION 🎀

so the tea is: flatpak search searches for applications and runtimes matching TEXT. periodt.

lowkey important thing tho — this uses appstream data, which is the same data that gets refreshed by the flatpak update command. so if your search results are looking a little crusty and outdated, that's why 🙈

and here's the fine print: that appstream data is updated automatically only if it's at least a day old. so it's not refreshing every five seconds, bestie, it's on a lil 24-hour vibe check. ⏰

✨ OPTIONS ✨

here's everything you can tack on. the following options are understood:

  • -u, --user — only search through remotes in the per-user installation. just your stuff, nobody else's 🎀
  • --system — only search through remotes in the default system-wide installation. the big communal one 💫
  • --installation=NAME — show a system-wide installation by NAME, picked from the ones defined in /etc/flatpak/installations.d/. and fyi, using --installation=default is equivalent to using --system, so they're the same thing in a different outfit 💅
  • -h, --help — show help options and exit. your little escape hatch 🚪
  • -v, --verbose — print debug information during command processing. for when you need to see everything 👀
  • --ostree-verbose — print OSTree debug information during command processing. even more. even deeper. the lore 🌀
  • --columns=FIELD,... — specify what information to show about each result. you can list multiple fields, or use this option multiple times. mix and match, no rules 🎨

and here's a cute lil trick: append :s[tart], :m[iddle], :e[nd] or :f[ull] to column names to change ellipsization. yes that's a real word. yes it means how the text gets cut off when it's too long. the more you know 🌈

🔥 FIELDS 🔥

these are the fields the --columns option understands. collect them all:

  • name — Show the name
  • description — Show the description
  • application — Show the application ID
  • version — Show the version
  • branch — Show the branch
  • remotes — Show the remotes
  • all — Show all columns
  • help — Show the list of available columns
ngl a lil bonus fact that's actually useful: field names can be abbreviated to a unique prefix. so you don't have to type the whole thing out. lazy girlies win again 😌💅

🌟 SEE ALSO 🌟

go read that one next, bestie, it's the whole family 🫶

💀 and that's the whole page!! no cap, you now know how to search for apps and runtimes like a certified icon.

this lil gem came to you from flatpak, in the FLATPAK SEARCH(1) manual page 🌸✨ stay searching, stay slaying, bye bestie 💖🦋

📦 where this page comes from