<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 5. Services</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.3.2" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="AppStream-AppStream-0.11-en-US-0.0-0" /><link rel="home" href="index.html" title="AppStream" /><link rel="up" href="index.html" title="AppStream" /><link rel="prev" href="sect-Quickstart-Translation.html" title="4.4. Translating Metadata" /><link rel="next" href="sect-AppStream-Services-UrlHandler.html" title="5.2. Url handler" /></head><body><p id="title"><a class="left" href="http://www.freedesktop.org/wiki/Distributions/AppStream/"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="http://www.freedesktop.org/software/appstream/docs/"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="sect-Quickstart-Translation.html"><strong>Prev</strong></a></li><li class="home">AppStream</li><li class="next"><a accesskey="n" href="sect-AppStream-Services-UrlHandler.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="chap-AppStream-Services">
</a>Chapter 5. Services</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="chap-AppStream-Services.html#sect-AppStream-Services-Screenshots">5.1. Screenshot service</a></span></dt><dt><span class="section"><a href="sect-AppStream-Services-UrlHandler.html">5.2. Url handler</a></span></dt></dl></div><div class="para">
AppStream provides some services to fetch additional data from.
</div><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="sect-AppStream-Services-Screenshots">
</a>5.1. Screenshot service</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="spec-screenshots-introduction">
</a>5.1.1. Introduction</h3></div></div></div><div class="para">
To make give users an impression on how the application they are about to install will look like, screenshots are provided in the AppStream spec. But since not all upstream authors ship screenshots, there is a way for distributors to specify a server for screenshots provided by a 3rd-party.
</div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="spec-screenshots-service">
</a>5.1.2. Webservice</h3></div></div></div><div class="para">
Distributors provide a service like <a href="http://screenshots.debian.net/about">debshots</a>. They can either use the original <code class="literal">debshots</code> web application, which does not only work for Debian but also any other distribution, or they can set up their own service which mimicks the <code class="literal">debshots</code> API (OpenSUSE does that).
</div><div class="para">
In order to make a new screenshot service known to software-centers, distributors need to place information about their webservice in the config file of <code class="literal">libappstream</code>, whis is usually located at <code class="filename">/etc/appstream.conf</code>.
</div><div class="para">
The screenshot data will be inserted transparently into <a href="http://www.freedesktop.org/software/appstream/docs/api/AsScreenshot.html">AsScreenshot</a>, if the distributor has set the configuration flag. Authors of software-centers don't need to take care of this implementation detail.
</div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="sect-Quickstart-Translation.html"><strong>Prev</strong>4.4. Translating Metadata</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="sect-AppStream-Services-UrlHandler.html"><strong>Next</strong>5.2. Url handler</a></li></ul></body></html>
