GNU Photo
=========

GNU Photo is a small integration layer that ties two existing GNU/GNOME
photo tools together under one command:

  * gphoto2 / libgphoto2 - the command-line digital camera access library
    and tool (https://www.gphoto.org/).
  * gnome-photos - GNOME's graphical photo browser
    (https://wiki.gnome.org/Apps/Photos).

The 'gphoto' program is a thin dispatcher (see src/gphoto.c). It carries
no library dependencies of its own: it only decides which of the two
underlying programs to exec, and passes arguments through unchanged.

  gphoto --cli [ARGS...]   Run 'gphoto2 [ARGS...]'
  gphoto --gui [ARGS...]   Run 'gnome-photos [ARGS...]'
  gphoto [ARGS...]         Auto-detect: prefer the GUI when a graphical
                           session and gnome-photos are both available,
                           otherwise fall back to the gphoto2 CLI.
  gphoto --help            Show usage.

Dependencies
------------

  * A C compiler: gcc or clang (anything with C99 support).
  * GNU Autoconf >= 2.69 and GNU Automake, to regenerate the build system
    from a checkout (not needed when building from a release tarball).
  * pkg-config.
  * libgphoto2 >= 2.5.0 (development headers), required so that the
    gphoto2 CLI backend works at runtime and so future GNU Photo releases
    can call into libgphoto2 directly.
  * gphoto2, the command-line tool, for the CLI backend.
  * gnome-photos, for the graphical backend.

Building
--------

From a release tarball:

    ./configure
    make
    sudo make install

From a fresh checkout (no configure script yet):

    ./autogen.sh
    ./configure
    make
    sudo make install

'configure' will warn (but not fail) if gphoto2 or gnome-photos are not
found on PATH, since gphoto itself builds fine without them - they are
only needed at runtime.

License
-------

GNU Photo is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version. See COPYING for the full text.

Website
-------

https://www.gnomephoto.org
