This is the distribution of gThumb, an image viewer and browser utility
for the GNOME environment.

Information about gthumb can be found at https://wiki.gnome.org/Apps/Gthumb.


What is gThumb
==============

 * gThumb is an image browser

   + Browse your hard disk showing you thumbnails of image files.
   + Thumbnails are saved in the same database used by Nautilus so you
     don't waste disk space.
   + Automatically update the content of a folder.
   + Copy, move, delete images and folders.
   + Bookmarks of folders and catalogs.

 * gThumb is an image viewer

   + View single images (including GIF animations).  Supported image
     types are: BMP, JPEG, GIF, PNG, TIFF, TGA, ICO, XPM.
   + Optional support for RAW and HDR (high dynamic range) images.
   + View EXIF data attached to JPEG images.
   + View in fullscreen mode.
   + View images rotated, flipped, mirrored.

 * gThumb is an image organizer

   + Add comments to images.
   + Organize images in catalogs, catalogs in libraries.
   + Print images and comments.
   + Search for images on you hard disk and save the result as a catalog.
     Search criteria remain attached to the catalog so you can update it
     when you want.

 * gThumb is an image editor

   + Change image hue, saturation, lightness, contrast and adjust colors.
   + Scale and rotate images.
   + Save images in the following formats: JPEG, PNG, TIFF, TGA.
   + Crop images.
   + Red-eye removal tool.

 * gThumb is an advanced tool

   + Import images from a digital camera.
   + Slide Shows.
   + Set an image as Desktop background.
   + Create index image.
   + Rename images in series.
   + Convert image format.
   + Change images date and time.
   + JPEG lossless transformations.
   + Find duplicated images.


Licensing
=========

  This program is released under the terms of the GNU General Public
  License (GNU GPL).

  You can find a copy of the license in the file COPYING.


Compiling
=========

  In order to build this program you need a working GNOME environment
  version 2 or greater, with the development tools installed properly.
  The following is the detailed list of libraries you need:

	* glib			version >= 2.36.0
	* gtk			version >= 3.16
	* gthread
	* gmodule
	* gio-unix

  While not mandatory, these libraries greatly increase gThumb's
  basic usefulness:

	* exiv2			version >= 0.21
	  (embedded metadata support)

	* gstreamer		version >= 1.0.0
	  (video support)

	* libjpeg
	* libtiff
	  (jpeg and tiff writing support)


  These libraries are optional:

	* clutter		version >= 1.12.0
	* clutter-gtk		version >= 1.0.0
          (These libraries provide enhanced slideshow effects.)

	* libraw
          (This adds some support for RAW photos)



Extensions
==========

  gThumb has a plug-in system for extensions. Some standard features
  are implemented as extensions and are supplied with the standard
  distribution. Users may write (and share) additional extensions.

  See https://wiki.gnome.org/Apps/Gthumb/extensions for details.


Download
========

  * Tar archives can be found here:

    http://ftp.gnome.org/pub/GNOME/sources/gthumb

  * You can download and compile the latest development version using the
    following commands:

        git clone https://gitlab.gnome.org/GNOME/gthumb.git
        cd gthumb
        meson build
        ninja -C build
        sudo ninja -C build install

    More development information is available at
    https://wiki.gnome.org/Apps/Gthumb/development