Fix flatpak "No remote refs found similar to 'flathub'"
The Arch flatpak package file list includes usr/share/flatpak/remotes.d/flathub.flatpakrepo, and the Arch wiki says installing flatpak adds Flathub system-wide and gives the --user remote-add command used in the fix. The Flathub Discourse thread's answer states the cause verbatim: no flathub remote in the user installation, and the message is misleading because flatpak cannot tell a remote from a ref. flatpak is in neither Omarchy package list, so it is absent by default, and Omarchy's own GeForce NOW installer adds it with omarchy-pkg-add flatpak, the same command the fix uses. itsfoss supports the generic remote-add fix. Not exercised: flatpak commands, flatpak is not installed here.
Symptom
Installing anything from Flathub fails straight away:
error: No remote refs found similar to 'flathub'
It often happens with flatpak install --user ..., or inside a tool that installs runtimes per user (flatpak-builder from Flathub), even though flatpak install flathub ... worked another time.
Cause
flatpak looks the name up among the remotes of the installation it is using. Arch's flatpak package ships /usr/share/flatpak/remotes.d/flathub.flatpakrepo, so the system installation has Flathub out of the box, but the per-user installation (--user) starts with no remotes at all. The message is misleading because flatpak cannot tell whether flathub was meant as a remote or as an app or runtime name. On Omarchy flatpak is not installed by default, so it only appears once you add it.
Fix
See which installation has which remotes:
flatpak remotes --show-details
flatpak remotes --user
flatpak remotes --system
Add Flathub to the per-user installation:
flatpak remote-add --if-not-exists --user flathub https://dl.flathub.org/repo/flathub.flatpakrepo
Or to the system installation if it is missing there:
sudo flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
Or simply drop --user and install system-wide. On Omarchy 4, install flatpak itself first with omarchy-pkg-add flatpak, then log out and back in so its apps reach the launcher.
Verify
flatpak remotes --user (or --system) lists flathub, and flatpak search spotify returns results.