README.md 3.42 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

Paolo Bacchilega's avatar
Paolo Bacchilega committed
6 7
![Image](https://gitlab.gnome.org/GNOME/gthumb/raw/master/data/appdata/ss-viewer.png)

8
## Features
Paolo Bacchilega's avatar
Paolo Bacchilega committed
9

10
 * 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
 * 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
 * Image organizer
Paolo Bacchilega's avatar
Paolo Bacchilega committed
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.

37
 * Image editor
Paolo Bacchilega's avatar
Paolo Bacchilega committed
38

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.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
42 43
   + Crop images.
   + Red-eye removal tool.
Paolo Bacchilega's avatar
Paolo Bacchilega committed
44

45
 * Advanced tools
Paolo Bacchilega's avatar
Paolo Bacchilega committed
46

Paolo Bacchilega's avatar
Paolo Bacchilega committed
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

57 58 59 60 61
## 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
62

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

## Licensing
Paolo Bacchilega's avatar
Paolo Bacchilega committed
66 67

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

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

72
## Dependencies
73

74
  Mandatory libraries:
Paolo Bacchilega's avatar
Paolo Bacchilega committed
75

76
  * glib >= 2.38.0
77
  * gtk >= 3.16
78 79 80 81
  * 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 100
  * 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
101

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

104
  Tar archives:
Paolo Bacchilega's avatar
Paolo Bacchilega committed
105 106 107

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

108
  Git repository:
109

110 111 112 113 114 115 116 117
    git clone https://gitlab.gnome.org/GNOME/gthumb.git

## Installation

    cd gthumb
    meson build
    ninja -C build
    sudo ninja -C build install
Paolo Bacchilega's avatar
Paolo Bacchilega committed
118

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