SOURCE DIRECTORIES

A list of directories to process needs to be provided as positional parameters. Data from all directories will be combined into one output namespace.

--origin NAME

Set the AppStream data origin identifier. This can be a value like "debian-unstable-main" or "flathub".

--result-root DIR

Sets the directory where all generated output that is deployed to a user's machine is exported to. If this parameter is not set and we only have one directory to process, we use that directory as default output path.

If both --data-dir and --icons-dir are set, --result-root is not necessary and no data will be written to that directory.

--data-dir DIR

Override the directory where the generated AppStream metadata catalog will be written to. Data will be written directly to this directory, and no supdirectories will be created (unlike when using --result-root to set an output location).

--icons-dir DIR

Override the directory where the cached icons are exported to.

--hints-dir DIR

Set a directory where hints reported generated during metadata processing are saved to. If this parameter is not set, no HTML/YAML hint reports will be saved.

--media-dir DIR

If set, creates a directory with media content (icons, screenshots, ...) that can be served via a webserver. The metadata will be extended to include information about these remote media.

--media-baseurl URL

The URL under which the contents of a directory set via --media-dir will be served. This value must be set if a media directory is created.

--prefix DIR

Set the default prefix that is used in the processed directories. If none is set explicitly, /usr is assumed.

--print-report MODE

Print the issue hints report (that gets exported as HTML and YAML document when --hints-dir was set) to the console in text form.

Various print modes are supported: on-error only prints a short report if the run failed (default), short generates an abridged report that is always printed and full results in a detailed report to be printed.

--components COMPONENT-IDs

Set a comma-separated list of AppStream component IDs that should be considered for the generated metadata. All components that exist in the input data but are not mentioned in this list will be ignored for the generated output.

--no-color

Don't print colored output.

--verbose

Display extra debugging information

--version

Display the version number of appstreamcli compose