Installing Rapid Photo Downloader 0.9.0a5

The version of the program described here, 0.9.0a5, is alpha quality software, meaning that not all its features have been written. Learn more about its features here. Learn how to download the old version here.

Install script and release tarball

To get started, download both these files from Launchpad (you may need to right-click on the links and choose the "Save Link As" option):

The instructions below are mandatory. There is currently no other way to install the latest version. However on most systems it's easy to install, and trivial to uninstall.

The Rapid Photo Downloader PPA does not contain the latest version, and will likely not do so for some time.

The list of changes in each release is found in the ChangeLog.

Quickstart on Ubuntu, Debian-like and Fedora-like Systems

If you use Ubuntu 16.04 or newer, or Debian sid, or Fedora 23, or an equivalent, you can install Rapid Photo Downloader for your user using an convenient install script. To get started, first install pip, the Python tool for installing Python packages. On Ubuntu or Debian:

sudo apt-get install python3-pip

On Fedora:

sudo dnf install python3-pip python3-wheel

If using Fedora 23 or a distribution of a similar age, you should first make Python 3's installation tools up-to-date (be mindful of the mild caution below in Installation):

python3 -m pip install --user --upgrade pip

python3 -m pip install --user --upgrade setuptools

To install Rapid Photo Downloader, from a terminal window, run as your regular user (i.e. without sudo):

python3 install.py rapid-photo-downloader-0.9.0a5.tar.gz

Caution: untarring the archive, building it and installing it using
sudo python3 setup.py install
is not supported, and not recommended.

Finally, to uninstall:

python3 -m pip uninstall rapid-photo-downloader

If you installed the man pages, they are found in
/usr/local/share/man/man1

Software Requirements and Program Installation on Other Systems

The program is installed using the Python tool pip, which automates almost all aspects of the program's installation by using PyPi to download Python modules.

Rapid Photo Downloader requires:

Highly recommended, optional dependencies:

  • colorlog: generates coloured program output when running Rapid Photo Downloader from the terminal.
  • pyprind: shows a progress bar on the command line while running the program analyze_pv_structure.

Satisfying Software Requirements

While Rapid Photo Downloader's installer will automatically download and install most required Python modules not already found on your system, there are some it cannot install. You must install these Python modules and a few other programs prior to installing Rapid Photo Downloader. The Python module requirements are the Python 3 versions of:

The non-Python programs required are:

  • ExifTool
  • exiv2
  • Given python-gphoto2 will almost certainly be installed from PyPi, the development packages for libgphoto2 and Python3 must be installed first, e.g. libgphoto2-dev and python3-dev
  • Likewise, given pymediainfo will almost certainly be installed from PyPi, the package libmediainfo must be installed.
  • If installing pyzmq from PyPi, you must first install the development packages for libzmq3 and Python3, e.g. libzmq3-dev and python3-dev
  • Qt5 plugin for reading TIFF images
  • If installing rawkit from PyPi, libraw is required, e.g. libraw10 or libraw15.
  • If installing EasyGUI from PyPi, ensure the Tkinter package for Python 3 is installed.

Installation

After satisfying software requirements using your Linux distribution's standard package installation tools, you should install Rapid Photo Downloader using the following steps, assuming you use sudo to get super-user (root) access.

First, you may need to update your user's copy of pip and setuptools:

python3 -m pip install --user --upgrade pip

python3 -m pip install --user --upgrade setuptools

Caution: the previous two steps will update pip and setuptools for your user. Potentially this could negatively affect the installation of other, older Python packages by your user, but the risk is small and is normally nothing to worry about.

The following command will install all required and optional Python modules not already installed on your system, with the exception of those specified above in satisfying software requirements:

python3 install.py rapid-photo-downloader-0.9.0a5.tar.gz

Substitute the name of the correct compressed tar file if necessary, and run it as your regular user (i.e. without sudo).

Caution: untarring the archive, building it and installing it using
sudo python3 setup.py install
is not supported, and not recommended.

Uninstallation

Assuming you installed using the instructions above, run:

python3 -m pip uninstall rapid-photo-downloader

If you installed the man pages, they are found in
/usr/local/share/man/man1

Inferno