view web/installing.html @ 2916:ae6cdcd69d9f default tip

Merge with upstream/master.
author Matti Hamalainen <ccr@tnsp.org>
date Tue, 14 May 2019 11:46:50 +0300
parents 99245ee344a9
children
line wrap: on
line source

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" >
<html>
  <head>
    <meta name="generator" content="HTML Tidy for HTML5 for Linux version 5.2.0" />
    <title>Installing Geeqie</title>
  </head>
  <body>
    <div id="downloading">
      <h2>Downloading</h2>
      <p>Geeqie is available as a package with some distributions.</p>
      <p>
        The source tar of the latest formal release may be downloaded:
        <a href="http://geeqie.org/geeqie-1.3.tar.xz">http://geeqie.org/geeqie-1.3.tar.xz</a>
      </p>
      <p>However Geeqie is stable, and you may download the latest version (if you have installed git) from here:</p>
      <p>
        Either:
        <code>git clone git://www.geeqie.org/geeqie.git</code>
      </p>
      <p>
        Or:
        <code>git clone http://www.geeqie.org/git/geeqie.git</code>
      </p>
      <h2>Installation</h2>
      <p>
        List compile options:
        <code>./autogen.sh --help</code>
      </p>
      <p>
        Common options:
        <code>./autogen.sh --disable-gtk3</code>
        ,
      </p>
      <p>
        Compilation:
        <code>./autogen.sh [options]; make -j&lt;no. of cpu cores&gt;</code>
      </p>
      <p>
        Install:
        <code>[sudo] make install</code>
      </p>
      <p>
        Removal:
        <code>[sudo] make uninstall</code>
      </p>
      <h4>Note:</h4>
      <p>The zip and gzip files at geeqie.org and GitHub contain only the sources - they cannot, by themselves, be used to install Geeqie.</p>
      <p>
        It is recommended to always use
        <code>git clone  git://www.geeqie.org/geeqie.git</code>
        to download Geeqie. After installing Geeqie you may delete the folder you have cloned Geeqie into.
      </p>
      <p>However if you leave the folder intact, whenever new features or patches are available, execute:</p>
      <p>
        <code>git pull; sudo make uninstall; sudo make maintainer-clean; ./autogen.sh; make -j&lt;no. of cpu cores&gt;; sudo make install</code>
      </p>
      <p>Only the changed sources are downloaded, which makes this a quick operation.</p>
      <p>Your configuration file, history file and desktop files are not affected by this process.</p>
      <h2>Notes and changes for the latest release</h2>
      <p>
        See the NEWS file in the installation folder, or
        <a href="https://github.com/BestImageViewer/geeqie/blob/master/NEWS">Geeqie News at GitHub</a>
      </p>
      <p>
        And either the ChangeLog file or
        <a href="http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git;a=shortlog">Geeqie ChangeLog</a>
      </p>
      <h2>Requirements</h2>
      <h3>Required libraries:</h3>
      <pre>
        <code>
          GTK+ 3.00
          www.gtk.org
          enabled by default
          disable with configure option: --disable-gtk3
          or
          GTK+ 2.20
          disabled by default when GTK+3 libraries are found.
          enable with configure option: --disable-gtk3
          optional items map display and GPU acceleration are not available
          with GTK2
          
          Note: GTK+3 is still somehow experimental. It is needed for some
          features but we have several complains about the GTK+3 usability.
          
          So if you need a stable version, you are advised to compile it
          with GTK+2. If you want to play with the cool new features, use
          GTK+3.
        </code>
      </pre>
      <h3>Optional libraries:</h3>
      <pre>
        <code>
          lcms2 2.0
          or
          lcms 1.14
          www.littlecms.com
          for color management support
          enabled by default
          disable with configure option: --disable-lcms
          
          exiv2 0.11
          www.exiv2.org
          for enhanced exif support
          enabled by default
          disable with configure option: --disable-exiv2
          
          lirc
          www.lirc.org
          for remote control support
          enabled by default
          disable with configure option: --disable-lirc
          
          libchamplain-gtk 0.12
          libchamplain 0.12
          libclutter 1.0
          wiki.gnome.org/Projects/libchamplain
          for map display
          enabled by default
          disable with configure option: --disable-map
          
          libclutter 1.0
          www.clutter-project.org
          for GPU acceleration (a check-box on Preferences/Image must also be ticked)
          enabled by default
          disable with configure option: --disable-gpu-accel
          explicitly disabling will also disable the map feature
          
          lua 5.1
          www.lua.org
          support for lua scripting
          enabled by default
          disable with configure option: --disable-lua

          librsvg2-common
          for displaying .svg images

          libwmf0.2-7-gtk
          for displaying .wmf images

          (see also "Additional pixbuf loaders" in the References section of the Help file)

          awk
          when running Geeqie, to use the geo-decode function
          
          markdown
          when compiling Geeqie, to create this file in html format

         libffmpegthumbnailer 2.1.0
         for thumbnailing camera video clips
         enabled by default
         disable with configure option: --disable-libffmpegthumbnailer
        </code>
      </pre>
    </div>
  </body>
</html>