OS Manuals

/usr/bin/appstreamcli

freedesktop.org AppStream reference implementation

From appstream 1.2.2-r1 (enterprise-packages), captured 2026-11-08 by running appstreamcli --help (exit 0). permalink

Usage:
  appstreamcli [OPTION…] COMMAND

AppStream command-line interface

Subcommands:
  search TERM                 - Search the component database. (Alias: 's')
  get COMPONENT-ID            - Get information about a component by its ID.
  what-provides TYPE VALUE    - Get components which provide the given item. Needs an item type (e.g.
                                lib, bin, python3, …) and item value as parameter.
  list-categories NAMES       - List components that are part of the specified categories.

  dump COMPONENT-ID           - Dump raw XML metadata for a component matching the ID.
  refresh-cache               - Rebuild the component metadata cache. (Alias: 'refresh')

  validate FILE                     - Validate AppStream XML files for issues.
  validate-tree DIRECTORY           - Validate an installed file-tree of an application for valid metadata.
  check-license LICENSE             - Check license string for validity and print details about it.
  is-satisfied FILE|COMPONENT-ID    - Check if requirements of a component (via its ID or MetaInfo file)
                                      are satisfied on this system.
  check-syscompat FILE|COMPONENT-ID - Check compatibility of a component (via its ID or MetaInfo file) with
                                      common system and chassis types.

  install COMPONENT-ID        - Install software matching the component-ID.
  remove COMPONENT-ID         - Remove software matching the component-ID.

  status                      - Display status information about available AppStream metadata.
  sysinfo                     - Show information about the current device and used operating system.
  put FILE                    - Install a metadata file into the right location.
  convert FILE FILE           - Convert metadata catalog XML to YAML or vice versa.
  vercmp VER1 [COMP] VER2     - Compare two version numbers. (Alias: 'compare-versions')

  new-template TYPE FILE                        - Create a template for a metainfo file (to be filled out by the
                                                  upstream project).
  make-desktop-file MI_FILE DESKTOP_FILE        - Create a desktop-entry file from a metainfo file.
  news-to-metainfo NEWS_FILE MI_FILE [OUT_FILE] - Convert a YAML or text NEWS file into metainfo releases.
  metainfo-to-news MI_FILE NEWS_FILE            - Write NEWS text or YAML file with information from a metainfo file.

  list-reviews COMPONENT-ID   - List online user reviews for a software component.

You can find information about subcommand-specific options by passing "--help" to the subcommand.

Help Options:
  -h, --help       Show help options

Application Options:
  --version        Show the program version.
  --verbose        Show extra debugging information.
  --no-color       Don't show colored output.
  --profile        Enable profiling
Options (5)
OptionDescriptionSource
-h, --helpShow help optionshelp
--versionShow the program version.help
--verboseShow extra debugging information.help
--no-colorDon't show colored output.help
--profileEnable profilinghelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.