Improve ability to control manual focus
[entangle:entangle.git] / 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 libvirt-sandbox 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/libvirt-sandbox
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/libvirt-sandbox/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  lcms                  >= 1.18
49  libpeas               >= 0.5.5
50  gexiv2                >= 0.2.2
51  LibRaw                >= 0.9.0
52
53
54 Communication
55 -------------
56
57 To communicate with the development team, or to post patches
58 there is a technical mailing list:
59
60    https://mail.gna.org/listinfo/entangle-devel/
61
62 Bugs found when using an OS distribution's binary packages should
63 be reported to the OS vendors' own bug tracker first. Otherwise
64 they can be reported to
65
66    https://gna.org/bugs/?group=entangle
67
68 The latest libvirt-sandbox code can be found in GIT at:
69
70    https://gitorious.org/entangle/entangle
71
72 For further information visit
73
74    http://entangle-photo.org/
75
76 Translators please see po/README.I18N for more guidance.
77
78 UI shortcuts
79 ------------
80
81 There are a number of shortcuts available for common operations
82
83  - 's' - Trigger the shutter, to shoot a picture
84  - 'p' - Toggle 'live view' preview mode
85  - 'esc' - Cancel the current operation
86  - 'm' - Toggle aspect ratio image mask
87  - 'h' - Toggle linear / logarithmic histogram
88  - 'a' - Drive autofocus during preview
89  - ',' or '.' - Drive manual focus during preview (fine control)
90  - '<' or '>' - Drive manual focus during preview (coarse control)
91
92 License
93 -------
94
95 Entangle is distributed under the terms of the GNU GPL v3+, except
96 for the Logo which is under the Creative Commons 1.0 Public
97 Domain Dedication.
98
99 Please see the COPYING file for the complete GPLv3+ license
100 terms, or visit <http://www.gnu.org/licenses/>.
101
102 -- End