Photini Documentation Release 2017.6.0.Dev819
Total Page:16
File Type:pdf, Size:1020Kb
Photini Documentation Release 2017.6.0.dev819 Jim Easterbrook Jun 02, 2017 Contents 1 Introduction 3 1.1 Features..................................................4 1.2 Dependencies...............................................5 1.3 Getting help...............................................6 1.4 Internationalisation............................................6 1.5 Licence..................................................6 2 Installation 9 2.1 All-in-one installer (Windows)......................................9 2.2 Package manager (some Linux distributions).............................. 10 2.3 Dependencies package (some Linux distributions)........................... 10 2.4 Piecemeal installation.......................................... 11 2.5 Essential dependencies.......................................... 11 2.6 Installing Photini............................................. 12 2.7 Running Photini............................................. 14 2.8 Photini documentation.......................................... 14 3 User manual 17 3.1 Image selector.............................................. 17 3.2 Descriptive metadata........................................... 23 3.3 Technical metadata............................................ 29 3.4 Geotagging................................................ 39 3.5 Flickr uploader.............................................. 53 3.6 Google Photos / Picasa uploader..................................... 60 3.7 Facebook uploader............................................ 66 3.8 Image importer.............................................. 77 3.9 Configuration............................................... 82 3.10 Tag reference............................................... 84 4 Typical workflow 89 4.1 Make a backup copy........................................... 89 4.2 Load images............................................... 89 4.3 Set text metadata............................................. 90 4.4 Save your work so far.......................................... 90 4.5 Set geolocation.............................................. 90 5 “Localisation” 91 i 5.1 Join Transifex.............................................. 92 5.2 Translating Photini............................................ 92 5.3 Testing your translations......................................... 93 6 Miscellaneous 95 6.1 Change Log............................................... 95 6.2 GNU General Public License...................................... 98 6.3 GNU Free Documentation License................................... 110 7 Further reading 119 ii Photini Documentation, Release 2017.6.0.dev819 Welcome to the documentation of Photini, an easy to use photograph metadata editor. For a quick introduction to Photini and its features I suggest you read the introduction. More detail about its capabilities can be found in the user manual. Contents 1 Photini Documentation, Release 2017.6.0.dev819 2 Contents CHAPTER 1 Introduction A free, easy to use, digital photograph metadata (EXIF, IPTC, XMP) editing application. “Metadata” is said to mean “data about data”. In the context of digital photographs this means information that isn’t essential in order to display the image, but tells you something about it. For example a title and description of the scene or the date & time and the GPS coordinates of the camera’s position when the picture was taken. “[Photini] doesn’t try to be an all-singing, all-dancing image management powerhouse - it just lets you add information to photos, quickly and easily.” —Linux Format magazine, January 2013 Why is it called Photini? Read my blog post on how I chose a name. 3 Photini Documentation, Release 2017.6.0.dev819 Features • Easy to use graphical interface. • Set photo title, description, keywords, copyright and creator fields. • Spell checking of some fields (optional). • Can set metadata for multiple images simultaneously. • Can adjust picture date & time and time zone (of multiple images simultaneously). • Reads EXIF, IPTC and XMP metadata, writes all three to maximise compatibility with other software. • Writes metadata to image files or to XMP “sidecar” files. • Can import photographs from many digital cameras. • Upload to Flickr and/or Facebook and/or Google Photos with reuse of metadata. 4 Chapter 1. Introduction Photini Documentation, Release 2017.6.0.dev819 • Geotagging - search map to find named places. • Choice of map providers - instantly switch to compare details. • Drag and drop images on to map to set GPS location. • Edit coordinates if required, or clear to unset GPS data. • Suggestions for further development welcome. Dependencies An “all in one” installer for Windows is available that installs Photini and all its dependencies. Users of other operating systems will need to install the following: • Python, version 2.6+ (including Python 3): http://python.org/ • PyQt, version 4 or 5: http://www.riverbankcomputing.co.uk/software/pyqt/intro • six, version 1.5+: https://pypi.python.org/pypi/six/ • appdirs, version 1.3+: http://pypi.python.org/pypi/appdirs/ • gexiv2 (GObject Exiv2 wrapper), version 0.5+: https://wiki.gnome.org/Projects/gexiv2 1.2. Dependencies 5 Photini Documentation, Release 2017.6.0.dev819 • Python GObject bindings: – PyGObject: https://wiki.gnome.org/Projects/PyGObject or – pgi: https://pypi.python.org/pypi/pgi/ For details of how to download and install these, please see the installation documentation. Getting help If you encounter any problems installing or running Photini, please email [email protected] and I’ll respond as soon as I can. If you discover a bug and have a GitHub account then please file a bug report on the GitHub “issues” page. Internationalisation Work has begun on providing Photini in multiple languages. I rely on users to do the translation, as I am not fluent in any language other than English. If you’d like to help, please join the Photini team on Transifex. For more details, see the localisation documentation. Licence Photini - a simple photo metadata editor. http://github.com/jim-easterbrook/Photini Copyright (C) 2012-17 Jim Easterbrook [email protected] German translation by Jan Rimmek Spanish translation by Esteban Martinena & Cristos Ruiz Polish translation by “itdawid” This program 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. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http: //www.gnu.org/licenses/. Service terms and conditions Use of the Google map tab is subject to the Google Maps Terms of Use and Google Privacy Policy. Use of the Bing map tab is subject to the Microsoft Bing Maps Terms of Use and Microsoft Privacy Statement. The Flickr upload tab uses the Flickr API but is not endorsed or certified by Flickr. 6 Chapter 1. Introduction Photini Documentation, Release 2017.6.0.dev819 Privacy statement Photini does not directly gather any information from its users, but the online services it can use (maps, Flickr, Face- book, and Google Photos) may do so. You should read these services’ privacy policies before using them. Photini stores user preferences in a text file on the user’s computer. This file can be found in $HOME/.config/ photini/ (Linux) or %USERPROFILE%\AppData\Local\photini\ (Windows). OAuth access tokens for Flickr, Facebook, and Google Photos are securely stored on the user’s computer using Python keyring. Documentation licence Permission is granted to copy, distribute and/or modify the Photini documentation under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the documentation section entitled “GNU Free Documentation License”. 1.5. Licence 7 Photini Documentation, Release 2017.6.0.dev819 8 Chapter 1. Introduction CHAPTER 2 Installation There are three ways to install Photini. On Windows you can use an all-in-one installer. On some Linux distributions you might be able to use your package manager to install everything, or you may be able to use the package manager to install Photini’s dependencies and pip to install Photini. On other platforms you need to install several dependencies before installing Photini. All-in-one installer (Windows) The Windows installer creates a standalone Python installation with all the dependencies needed to run Photini. The standalone Python interpreter is only used to run Photini, and should not conflict with any other Python version installed on your computer. You can download the latest Windows installer from the GitHub releases page. It’s the file photini-win32-setup.exe included in the “downloads” section of the latest release. The installer is suitable for 32 bit and 64 bit Windows, and should work on any version since Windows XP. The installer should finish by running the Photini program. If this works then you have successfully installed Photini and can ignore the rest of these instructions. If not, see the troubleshooting section below. Upgrading all-in-one installation Before upgrading Photini you should check the change