Photini is an easy to use digital photograph metadata editor. “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 coördinates of the camera’s position when the picture was taken.
You can download the latest version of Photini from Github. If you have git installed on your computer, and are familiar with its use, then the best way to download it will be to clone the repository. This will make it easier to update your copy when new features are added or bugs are fixed.
If you prefer to download a single archive file, go to the Python Package Index (PyPI) and download the zip or tar.gz file. Save the file on your computer, then extract all the files in it in the usual way.
The next task is to install the various dependencies.
Many Linux installations will already have Python installed, but if not you should be able to get it easily from the standard repository. This should also be the case for PyQt. GExiv2 may be in the repository. If not, you should be able to build and install it yourself. See the “Building and installing” instructions for details. On my OpenSUSE Linux computer I needed to install the libexiv2-devel, gobject-introspection-devel and typelib-1_0-GExiv2 packages before building GExiv2.
If you can’t install GExiv2 you can use pyexiv2 instead. It is no longer maintained, so GExiv2 is preferable, but pyexiv2 may be in the repository. If not, you should be able to download it from the pyexiv2 download page. As a last resort, you may need to compile and install it yourself, following these instructions.
The last essential dependency is a small Python utility called appdirs. The best way to install this is with pip, an easy to use installer for packages from PyPI.
If you would like to use Photini to upload photos to Flickr, you will also need to install python-flickrapi. This is available from some Linux distributions’ repositories, or via pip. See the python-flickrapi website for details.
Similarly, to upload to Google Picasa requires gdata-python-client. This is called python-gdata in some Linux repositories.
Windows users will probably need to install Python and PyQt themselves. Installers are available from the Python download page and the PyQt4 download page. Make sure you get Python version 2.7 and the corresponding PyQt installer. Windows installers for pyexiv2 are available from the pyexiv2 download page. Again, make sure you get the installer for Python 2.7 and the latest version of pyexiv2.
The last essential dependency is a small Python utility called appdirs. The best way to install this is with pip, an easy to use installer for packages from PyPI.
If you would like to use Photini to upload photos to Flickr, you will also need to install python-flickrapi. This appears to be a pure Python package, so pip is probably the best way to install it on Windows. See the python-flickrapi website for details.
Similarly, to upload to Google Picasa requires gdata-python-client.
Having installed all the dependencies it’s a good idea to test Photini. Open a terminal command window and navigate to the directory you downloaded it to, then navigate to the code subdirectory. You should then be able to run the Photini editor with one of the following commands.
Linux:
python -m photini.editor
Windows:
c:\python27\python.exe -m photini.editor
This should launch the GUI and you should then be able to switch to the “map” tab and load a Google map.
Whilst it is perfectly possible to use Photini from its download directory, it is more convenient to install it in your Python’s “site-packages” and “scripts” directories. This is fully automated by the setup.py script.
Linux:
python setup.py build
sudo python setup.py install
Windows:
c:\python27\python.exe setup.py build
c:\python27\python.exe setup.py install
After doing this the Photini editor can be launched from any command window with a simple photini command. Windows users can also put a link to c:\python27\scripts\photini.bat on their desktop.