README.md 3.64 KB
Newer Older
1
# gThumb
Paolo Bacchilega's avatar
Paolo Bacchilega committed
2

3 4
An image viewer and browser utility for the GNOME environment.
More information can be found at https://wiki.gnome.org/Apps/Gthumb.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
5

6
## Features
Paolo Bacchilega's avatar
Paolo Bacchilega committed
7

8
 * gThumb is an image browser
Paolo Bacchilega's avatar
Paolo Bacchilega committed
9 10 11 12 13 14 15 16

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

17
 * gThumb is an image viewer
Paolo Bacchilega's avatar
Paolo Bacchilega committed
18 19

   + View single images (including GIF animations).  Supported image
20
     types are: BMP, JPEG, GIF, PNG, TIFF, TGA, ICO, XPM.
21
   + Optional support for RAW and HDR (high dynamic range) images.
22
   + View EXIF data attached to JPEG images.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
23 24 25
   + View in fullscreen mode.
   + View images rotated, flipped, mirrored.

26
 * gThumb is an image organizer
Paolo Bacchilega's avatar
Paolo Bacchilega committed
27 28 29 30 31 32 33 34 35 36

   + 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

37
   + Change image hue, saturation, lightness, contrast and adjust colors.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
38 39
   + Scale and rotate images.
   + Save images in the following formats: JPEG, PNG, TIFF, TGA.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
40 41
   + Crop images.
   + Red-eye removal tool.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
42 43 44

 * gThumb is an advanced tool

Paolo Bacchilega's avatar
Paolo Bacchilega committed
45
   + Import images from a digital camera.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
46 47 48 49 50 51 52 53
   + 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.
54

55 56 57 58 59
## 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.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
60

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

## Licensing
Paolo Bacchilega's avatar
Paolo Bacchilega committed
64 65

  This program is released under the terms of the GNU General Public
66
  License (GNU GPL), either version 2 of the License, or (at your option) any
67
  later version.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
68 69 70

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

71
## Compiling
72

73
  In order to build this program you need GNOME 3, with the development tools installed properly.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
74 75
  The following is the detailed list of libraries you need:

76 77 78 79 80 81
  * glib >= 2.38.0
  * gtk  >= 3.16
  * libpng
  * zlib
  * libjpeg
  * gsettings-desktop-schemas
82

83
  While not mandatory, the following libraries greatly increase gThumb's basic usefulness:
84

85 86 87
  * exiv2: embedded metadata support;
  * gstreamer, gstreamer-plugins-base, gstreamer-video: audio/video support;
  * libtiff: tiff writing support.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
88

89
  Other optional libraries:
90

91 92 93 94 95 96 97 98 99
  * libraw: some support for RAW photos;
  * librsvg: display SVG images;
  * libwebp: display and save WebP images;
  * lcms2, colord: color profile support;
  * champlain, champlain-gtk: view the place a photo was taken on a map;
  * clutter, clutter-gtk: enhanced slideshow effects;
  * libsoup, json-glib, webkit2gtk, libsecret: upload images to and download images from some web services such as facebook, flickr;
  * brasero: write images and comments to CDs;
  * bison, flex: web albums.
100

101
## Download
Paolo Bacchilega's avatar
Paolo Bacchilega committed
102

103
  * Tar archives can be found here:
Paolo Bacchilega's avatar
Paolo Bacchilega committed
104 105 106

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

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

Paolo Bacchilega's avatar
Paolo Bacchilega committed
110
        git clone https://gitlab.gnome.org/GNOME/gthumb.git
111
        cd gthumb
112 113 114
        meson build
        ninja -C build
        sudo ninja -C build install
Paolo Bacchilega's avatar
Paolo Bacchilega committed
115

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