Product SiteDocumentation Site

AppStream 0.12


Infrastructure for distro-agnostic software-centers and universal software component metadata

Edition 1

Matthias Klumpp


Michael Vogt

Canonical / Ubuntu / Debian

Richard Hughes

Fedora / Red Hat

Vincent Untz


Legal Notice

Copyright © 2012-2019 Matthias Klumpp. This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 with no invariant sections or later (the latest version is presently available at


AppStream is a collaborative effort for enhancing the way we interact with the software repositories provided by the distribution by standardizing sets of additional metadata.
AppStream provides the foundation to build software-center applications. It additionally provides specifications for things like an unified software metadata database, screenshot services and various other things needed to create user-friendly application-centers for software distributions.
You can find a C/GLib based reference implementation of the specification here and report bugs about the implementation as well as the specification itself at the issue tracker.
1. About AppStream
1.1. What is AppStream?
2. Upstream Metadata
2.1. Generic Component
2.2. Desktop Applications
2.3. Console Applications
2.4. Web Applications
2.5. Services
2.6. Addons
2.7. Fonts
2.8. Icon Themes
2.9. Codecs
2.10. Input Methods
2.11. Firmware
2.12. Driver
2.13. Localization
2.14. Repositories
2.15. Operating System
3. Collection Metadata
3.1. AppStream collection XML
3.2. AppStream collection YAML
3.3. Icon Cache
4. Metadata Quickstart
4.1. For GUI application upstream maintainers
4.2. For upstream projects providing addons
4.3. For distributors packaging Appstream metadata
4.4. Translating Metadata
5. Services
5.1. Screenshot service
5.2. URI Handler
6. Manual pages
7. AppStream API Reference