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