Xfce Wiki

Sub domains

Ristretto Image Viewer


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.12.3 released (2022/07/09 22:54)
    ristretto 0.12.3 is now available for download from
    What is ristretto?
    Ristretto is an image-viewer for the Xfce desktop environment.
    Release notes for 0.12.3
    - Bug Fixes:
      - thumbnailer: Fall back on lower qualities in case of
        unsupported flavor (#81)
      - Secure error handling when opening multiple files
      - Use `G_FILE_MONITOR_WATCH_MOVES` for file monitoring
      - Do not keep sticky state when current file is removed
      - Fix management of transaction source id
      - Correctly handle deletion when there is only one image (#89)
      - Update iter list on insertion and deletion (#88)
      - build: Fix intltool lock file problem during make distcheck
      - Display error message on stderr
      - i18n: Use `xfce_textdomain()` to initialize translations
      - Ensure that an error is set if no pixbuf is available
      - Fix some memory leaks
    - Code Refactoring:
      - flatpak: Some updates from Flathub
      - Remove old icon files
      - Remove TODO file
      - Flatpak: Add libopenraw dependency
    - Translation Updates:
      Chinese (China), Danish, Greek, Korean, Malay, Portuguese (Brazil),

Back to Top

Source Code Repository

Reporting Bugs

Back to Top

Back to main Xfce documentation page