Xfce Wiki

Sub domains
 

This is an old revision of the document!

Ristretto Image Viewer

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 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

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

  • ristretto 0.14.0 released (2026/03/08 12:07)
    ristretto 0.14.0 is now available for download from https://archive.xfce.org/src/apps/ristretto/0.14/ristretto-0.14.0.tar.xz https://archive.xfce.org/src/apps/ristretto/0.14/ristretto-0.14.0.tar.xz?sha1 https://archive.xfce.org/src/apps/ristretto/0.14/ristretto-0.14.0.tar.xz?sha256 What is ristretto? ================== Ristretto is an image-viewer for the Xfce desktop environment. Website: https://docs.xfce.org/apps/ristretto/start Release notes for 0.14.0 ======================== - build: Rename POTFILES.in to POTFILES - Autoscale image when printing only when bigger than page size - Improve printing management - image-list: Avoid undefined behavior with zero-length vla - metadata: Add vcs-browser URL - Use CAIRO_FILTER_GOOD instead of BILINEAR when smoothing is enabled - build: Fix typo in optimization level - Set prgname to application ID - ephemeral-file: Don't show directory loading error for non-native filesystems - ephemeral-file: Treating files received via http, https as ephemeral - ephemeral-file: Treating /dev/stdin as an ephemeral file - ephemeral-file: Handling ephemeral files in the interface - ephemeral-file: Added ephemeral flag to RsttoFile - sort-sync: Fix a RsttoFileManagerIntegration leak - preferences: Fix string leak in cb_update_file_manager_buttons - sort-sync: Implementation of integration with Thunar - sort-sync: Infrastructure for integration with a file manager - sort-sync: Sorting by type has a fallback path if the type is the same - sort-sync: Added sorting direction - sort-sync: Added sorting by file size - Fix leaks with GtkRecentFilter objects - README.md: Add uninstall info - Remove autotools build - Fix scan-build job - Add option to shuffle images - Fix a -Wunreachable-code-break warning reported by clang - Fix a -Wduplicated-branches warning with GCC - main_window: Fix -Wcomma warnings - Update README after switchover to meson - flatpak: Drop unused patch - Translation Updates: Albanian, Arabic, Armenian (Armenia), Basque, Belarusian, Bulgarian, Catalan, Chinese (China), Chinese (Taiwan), Croatian, Czech, Danish, Dutch, Eastern Armenian, English (Australia), English (United Kingdom), Estonian, Finnish, French, Galician, German, Greek, Hebrew, Hungarian, Icelandic, Indonesian, Interlingue, Italian, Japanese, Kazakh, Korean, Lithuanian, Malay, Norwegian Bokmål, Occitan (post 1500), Polish, Portuguese, Portuguese (Brazil), Romanian, Russian, Serbian, Slovak, Slovenian, Spanish, Swedish, Telugu, Thai, Turkish, Ukrainian, Uyghur, Vietnamese

Back to Top

Source Code Repository

https://gitlab.xfce.org/apps/ristretto

Reporting Bugs

Back to Top

Back to main Xfce documentation page