~~NOTOC~~
{{ :xfce:xfce.ristretto.png?no link|}}
====== Ristretto Image Viewer ======

  * **[[#Manual actions required for some version changes|Manual actions required for some version changes]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====
The Ristretto Image Viewer is an application that can be used to view, and scroll through images. It can be used to run a slideshow of images, open images with other applications like an image-editor or configure an image as the desktop wallpaper.

The image types supported by Ristretto are those supported by the [[https://gitlab.gnome.org/GNOME/gdk-pixbuf|gdk-pixbuf library]]. This library itself supports a number of basic image types (JPEG, PNG, TIFF, etc.), but then relies on optional libraries to extend the range of supported image types. This means that you will have to install these libraries yourself to extend the range of image types supported by Ristretto. Examples: libwmf, libopenraw, libavif, libheif, libjxl, librsvg, webp-pixbuf-loader.

The following describes how you can use Ristretto, and how you can configure it to your preferences.

----

===== Image Viewer =====

  * **[[getting-started|Getting Started]]** -- Starting Ristretto for the first time
  * **[[preferences|Preferences]]** -- Configure Ristretto

----

===== Manual actions required for some version changes =====

As of version **0.12.0**, the name of the Ristretto launcher has changed from ''ristretto.desktop'' to ''org.xfce.ristretto.desktop'', which breaks the mime type mapping. To fix this, just run this command:

   sed -Ei.bak 's/([=;])(ristretto.desktop)/\1org.xfce.\2/' ~/.config/mimeapps.list

The original mime type file will be kept as ''~/.config/mimeapps.list.bak'' after running this command.

===== Latest Release =====

{{rss>https://archive.xfce.org/feeds/project/ristretto 1 date 2h}}

[[https://gitlab.xfce.org/apps/ristretto/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/apps/ristretto/|Download current release]]** (link also contains older versions)

[[|Back to Top]]

----
===== Source Code Repository =====
[[https://gitlab.xfce.org/apps/ristretto|]]

----

===== Reporting Bugs =====

  * **[[bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs


[[|Back to Top]]
----
[[:start|Back to main Xfce documentation page]]