README 3.45 KB
Newer Older
Paolo Bacchilega's avatar
Paolo Bacchilega committed
1
This is the distribution of gThumb, an image viewer and browser utility
2
for the GNOME environment.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
3

4
Information about gthumb can be found at https://wiki.gnome.org/Apps/Gthumb.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
5

6

Paolo Bacchilega's avatar
Paolo Bacchilega committed
7 8 9
What is gThumb
==============

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

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

19
 * gThumb is an image viewer
Paolo Bacchilega's avatar
Paolo Bacchilega committed
20 21

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

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

   + 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

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

 * gThumb is an advanced tool

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

Paolo Bacchilega's avatar
Paolo Bacchilega committed
57 58 59

Licensing
=========
Paolo Bacchilega's avatar
Paolo Bacchilega committed
60 61

  This program is released under the terms of the GNU General Public
62
  License (GNU GPL).
Paolo Bacchilega's avatar
Paolo Bacchilega committed
63 64 65

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

66

Paolo Bacchilega's avatar
Paolo Bacchilega committed
67 68 69 70
Compiling
=========

  In order to build this program you need a working GNOME environment
71
  version 2 or greater, with the development tools installed properly.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
72 73
  The following is the detailed list of libraries you need:

74 75
	* glib			version >= 2.36.0
	* gtk			version >= 3.16
76
	* gthread
77
	* gmodule
78 79 80 81 82
	* gio-unix

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

83
	* exiv2			version >= 0.21
84 85
	  (embedded metadata support)

86
	* gstreamer		version >= 1.0.0
87 88
	  (video support)

89
	* libjpeg
90 91 92
	* libtiff
	  (jpeg and tiff writing support)

Paolo Bacchilega's avatar
Paolo Bacchilega committed
93

94
  These libraries are optional:
Paolo Bacchilega's avatar
Paolo Bacchilega committed
95

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

100
	* libraw
101
          (This adds some support for RAW photos)
102

103

104

105 106 107 108 109 110 111
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.

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

114

Paolo Bacchilega's avatar
Paolo Bacchilega committed
115 116 117
Download
========

118
  * Tar archives can be found here:
Paolo Bacchilega's avatar
Paolo Bacchilega committed
119 120 121

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

122 123 124 125 126 127 128 129 130
  * If you know what git is and how to use it, you can download and
    compile the latest development version using the following
    commands:

        git clone git://git.gnome.org/gthumb
        cd gthumb
        ./autogen.sh --prefix=/usr CFLAGS="-ggdb"
        make
        sudo make install
Paolo Bacchilega's avatar
Paolo Bacchilega committed
131

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