[![License](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://gitlab.xfce.org/apps/ristretto/-/blob/master/COPYING)

# ristretto

Ristretto is an image viewer for the [Xfce](https://www.xfce.org/) desktop environment.

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

----

### Homepage

[Ristretto documentation](https://docs.xfce.org/apps/ristretto/start)

### Changelog

See [NEWS](https://gitlab.xfce.org/apps/ristretto/-/blob/master/NEWS) for details on changes and fixes made in the current release.

### Source Code Repository

[Ristretto source code](https://gitlab.xfce.org/apps/ristretto)

### Download a Release Tarball

[Ristretto archive](https://archive.xfce.org/src/apps/ristretto)
    or
[Ristretto tags](https://gitlab.xfce.org/apps/ristretto/-/tags)

### Installation

From source code repository:

    % cd ristretto
    % meson setup build
    % meson compile -C build
    % meson install -C build

From release tarball:

    % tar xf ristretto-<version>.tar.xz
    % cd ristretto-<version>
    % meson setup build
    % meson compile -C build
    % meson install -C build

From [Flathub](https://flathub.org/apps/details/org.xfce.ristretto):

    % flatpak install flathub org.xfce.ristretto

### Uninstallation

From source code repository or tarball:

    % ninja uninstall -C build

### Reporting Bugs

Visit the [reporting bugs](https://docs.xfce.org/apps/ristretto/bugs) page to view currently open bug reports and instructions on reporting new bugs or submitting bugfixes.

