LinuxCommandLibrary

flatpak-remote-info

Show information about a Flatpak remote

TLDR

Show information about a flatpak

$ flatpak remote-info [remote_name] [com.example.app]
copy

Show a log of previous versions in a remote
$ flatpak remote-info --log [remote_name] [com.example.app]
copy

Show information about the specific commit, rather than the latest version
$ flatpak remote-info --commit=[COMMIT] [remote_name] [com.example.app]
copy

SYNOPSIS

flatpak-remote-info [OPTIONS] <REMOTE> [<REF>]

PARAMETERS

--user
    Operates on the per-user installation.

--system
    Operates on the system-wide installation (default).

--installation=
    Specifies a named installation to operate on.

--show-sizes
    Displays the download and installed sizes of components when querying a <REF>.

--no-summary
    Suppresses the display of the remote's summary information.

--no-fsck
    Skips the file system consistency check of the remote during information retrieval.

--mirror
    Shows additional mirror-related information if the remote is configured as such.

--bare-ref
    Interprets the provided <REF> as a bare Flatpak reference string.

--cached
    Uses only cached remote information without attempting to download new data from the network.

--columns=FIELD,...
    Specifies a comma-separated list of fields to output when querying a specific <REF> (e.g., 'name,description,version').

--arch=
    Filters the information to show details for a specific architecture.

--all
    Shows information for all available architectures (implies --columns).

-h, --help
    Displays a help message with command usage and available options.

-v, --verbose
    Prints verbose debugging information during execution.

--ostree-verbose
    Prints verbose debugging information specifically for OSTree operations.

DESCRIPTION

The flatpak-remote-info command provides detailed information about a configured Flatpak remote or a specific Flatpak reference (application or runtime) within that remote. It allows users to inspect properties such as the remote's URL, GPG key, collection ID, and whether it's enabled. When a <REF> (like org.kde.Kdenlive) is specified, it retrieves metadata for that particular application or runtime, including its description, version, size, dependencies, and available architectures. This command is crucial for understanding the contents and configuration of Flatpak repositories, aiding in debugging, verifying remote setup, or exploring available software before installation. It can operate on user-specific or system-wide installations, and provides options to filter or format the output.

CAVEATS

Using --cached might provide outdated information if the remote has been updated recently and the local cache hasn't been refreshed.
Information for a specific <REF> might vary based on the available architectures and branches on the remote.
The command requires network access to fetch up-to-date information unless --cached is used.
Output formatting can be extensive when querying a <REF> without --columns, making it challenging to parse programmatically.

EXAMPLES

To display general information about a remote named "flathub":
flatpak-remote-info flathub

To display information about a specific application (GIMP) from "flathub":
flatpak-remote-info flathub org.gimp.GIMP

To display only the name, description, and version of an application from "flathub":
flatpak-remote-info --columns=name,description,version flathub org.gimp.GIMP

To display information including sizes for an application:
flatpak-remote-info --show-sizes flathub org.gimp.GIMP

To query a user-specific remote:
flatpak-remote-info --user my-user-remote

HISTORY

The flatpak-remote-info command is an integral part of the Flatpak ecosystem, which originated as xdg-app around 2014-2015 and was officially renamed to Flatpak in 2016. Its functionality has been core since the early days, providing transparency into the contents of Flatpak repositories. As Flatpak evolved, this command gained more options like --show-sizes and --columns to provide more granular control over the displayed information, reflecting the growing complexity and adoption of the Flatpak packaging system. It has consistently served as a vital tool for repository management and application discovery within the Flatpak framework.

SEE ALSO

flatpak(1), flatpak-remote-add(1), flatpak-remote-delete(1), flatpak-remote-list(1), flatpak-install(1)

Copied to clipboard