README

   1        Entangle: Tethered Camera Control & Capture
   2        ===========================================
   3
   4 Entangle is an application which uses GTK and libgphoto2 to provide a
   5 graphical interface for tethered photography with digital cameras.
   6
   7 It includes control over camera shooting and configuration settings
   8 and 'hands off' shooting directly from the controlling computer.
   9
  10 Installation
  11 ------------
  12
  13 The Entangle package uses GNU autotools, so the build install
  14 process follows the standard process documented in the INSTALL file.
  15 As a quick start you can do
  16
  17   ./configure --prefix=/usr --sysconfdir=/etc \
  18         --localstatedir=/var --libdir=/usr/lib
  19   make
  20   sudo make install
  21
  22 Or to install into a private user specific location
  23
  24   ./configure --prefix=$HOME/usr/entangle
  25   make
  26   make install
  27
  28 NB, if not installing in /usr, you need to set the XDG_DATA_DIRS env
  29 variable to point to the data directory, eg in the above example use:
  30
  31   XDG_DATA_DIRS=/usr/share:/usr/local/share:$HOME/entangle/share
  32   export XDG_DATA_DIRS
  33
  34 OS distro packagers should use the --disable-schemas-compile arg
  35 to configure to skip the compilation stage for schema files if
  36 installing to the /usr prefix
  37
  38 Building entangle requires the following external packages to
  39 be present
  40
  41  glib2                 >= 2.26.0
  42  gdk-pixbf             >= 2.12.0
  43  gtk3                  >= 3.0.0
  44  libgphoto2            >= 2.4.11
  45  gudev                 >= 145
  46  dbus-glib             >= 0.60
  47  gobject-introspection >= 0.9.3
  48  lcms2                 >= 2.0
  49  libpeas               >= 0.5.5
  50  gexiv2                >= 0.2.2
  51  LibRaw                >= 0.9.0
  52  gnome-icon-theme-symbolic >= 3.0.0
  53
  54
  55 Communication
  56 -------------
  57
  58 To communicate with the development team, or to post patches
  59 there is a technical mailing list:
  60
  61    https://mail.gna.org/listinfo/entangle-devel/
  62
  63 Bugs found when using an OS distribution's binary packages should
  64 be reported to the OS vendors' own bug tracker first. Otherwise
  65 they can be reported to
  66
  67    https://gna.org/bugs/?group=entangle
  68
  69 The latest entangle code can be found in GIT at:
  70
  71    https://gitorious.org/entangle/entangle
  72
  73 For further information visit
  74
  75    http://entangle-photo.org/
  76
  77 Translators please see po/README.I18N for more guidance.
  78
  79 UI shortcuts
  80 ------------
  81
  82 There are a number of shortcuts available for common operations
  83
  84  - 's' - Trigger the shutter, to shoot a picture
  85  - 'p' - Toggle 'live view' preview mode
  86  - 'esc' - Cancel the current operation
  87  - 'm' - Toggle aspect ratio image mask
  88  - 'h' - Toggle linear / logarithmic histogram
  89  - 'a' - Drive autofocus during preview
  90  - ',' or '.' - Drive manual focus during preview (fine control)
  91  - '<' or '>' - Drive manual focus during preview (coarse control)
  92
  93 License
  94 -------
  95
  96 Entangle is distributed under the terms of the GNU GPL v3+, except
  97 for the Logo which is under the Creative Commons 1.0 Public
  98 Domain Dedication.
  99
 100 Please see the COPYING file for the complete GPLv3+ license
 101 terms, or visit <http://www.gnu.org/licenses/>.
 102
 103 -- End