Product SiteDocumentation Site

5.2. Url handler

5.2.1. Introduction

In order to allow installation of AppStream components from websites, software-centers implementing AppStream may choose to also support the appstream:// urls.
This allows upstream projects to trigger an installation of their application from their homepage on any supporting distribution. It also is helpful for web-based software-centers.

5.2.2. URL schema

Software-centers handling appstream:// URLs must provide a handler for the x-scheme-handler/appstream mimetype. An AppStream URL follows the schema appstream:%{component-id}.
Example HTML code:
<a href="appstream:org.kde.discover.desktop">Install KDE Discover</a>
<a href="appstream:org.gnome.Software.desktop">Install GNOME-Software</a>
<a href="appstream:org.freedesktop.AppStream">Install libappstream</a>

5.2.3. AppStream Buttons

If you want to allow users to open your software in their local software center from your website, you might want to use one of the easily recognizable AppStream buttons for your appstream: link.
SVG
SVG