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.

This manual 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.2 released (2022/01/14 12:33)
    ristretto 0.12.2 is now available for download from
    What is ristretto?
    Ristretto is an image-viewer for the Xfce desktop environment.
    Release notes for 0.12.2
    - New Features:
      - Thumbnailer: Add support for shared thumbnail repositories (#82)
      - Thumbnailer: Add thumbnail flavor support (#81)
    - Performance Improvement:
      - Optimization: Use TreeModel IFace to walk the image list
      - Optimization: Add index and list link to RsttoImageListIter
      - Optimization: Switch to GQueue in RsttoImageList
    - Code Refactoring:
      - Flatpak: Add lifecycle manager patch to Xfconf dependency
      - Flatpak: Add Tumbler dependency as a private service (!35)
      - Flatpak: Add pixbuf loaders
      - Refactoring: Cleanup and simplifications around thumbnail size
      - Redistribute thumbnail sizes uniformly
      - Disable debug checks in release mode
      - Cleanup: Miscellaneous
      - Cleanup: Remove unused APIs in RsttoImageList
    - Bug Fixes:
      - Fix and complete file change monitoring
      - Thumbnailer: Rework queue management
      - Thumbnailer: Properly set the number of visible items
      - Take the device scale into account to limit rendering quality
      - Avoid multi-threading issue with X11 (#76)
    - 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, Thai, Turkish,
      Ukrainian, Uyghur

Back to Top

Source Code Repository

Reporting Bugs

Back to Top

Back to main Xfce documentation page