diff options
Diffstat (limited to 'PKG-INFO')
| -rw-r--r-- | PKG-INFO | 232 |
1 files changed, 223 insertions, 9 deletions
@@ -1,15 +1,229 @@ -Metadata-Version: 1.0 +Metadata-Version: 1.1 Name: rapid-photo-downloader -Version: 0.4.11 -Summary: Rapid Photo Downloader for Linux +Version: 0.9.7 +Summary: Downloads, renames and backs up photos and videos from cameras, phones, memory cards and other devices Home-page: http://www.damonlynch.net/rapid Author: Damon Lynch Author-email: damonlynch@gmail.com License: GPL -Description: Rapid Photo Downloader is written by a photographer for professional and - amateur photographers. It can download photos and videos from multiple - cameras, memory cards and Portable Storage Devices simultaneously. It - provides many flexible, user-defined options for subfolder creation, - photo and video renaming, and backup. +Description: Rapid Photo Downloader + ====================== -Platform: linux + Contents + -------- + + - `Description`_ + - `Install on Ubuntu, openSUSE, Debian, and Fedora`_ + - `Supported Linux Versions`_ + - `Software Requirements and Program Installation on Other Systems`_ + - `Satisfying Software Requirements`_ + - `Installation`_ + - `Uninstallation`_ + + Description + =========== + + Rapid Photo Downloader imports photos and videos from cameras, phones, + memory cards and other devices at high speed. It can be configured to + rename photos and videos with meaningful filenames you specify. It can also + back up photos and videos as they are downloaded. It downloads from and backs + up to multiple devices simultaneously. + + Unique to Rapid Photo Downloader is its Timeline, which groups photos and + videos based on how much time elapsed between consecutive shots. Use it to + identify photos and videos taken at different periods in a single day or + over consecutive days. + + Written by a photographer_ for professional and amateur photographers, Rapid + Photo Downloader is easy to configure and use. Program preferences are + configured without the need for complicated codes. Common tasks can be + automated, such as unmounting a memory card when the download is complete. + + A helper command-line program accompanying Rapid Photo Downloader is + ``analyze_pv_structure``, which analyzes photos and videos to help determine + how much of a file needs to be read to extract its metadata and thumbnail. + + Rapid Photo Downloader currently runs only on Linux. Theoretically it could be + ported to both Mac and Windows with minimal effort. The one gotcha is that + that Windows lacks gphoto2, meaning when run under Windows, it could not + download directly from cameras unless it used something else. + + The program is licensed under the GPL3_ or later. + + Install on Ubuntu, openSUSE, Debian, and Fedora + =============================================== + + To install Rapid Photo Downloader, run as your regular user (i.e. *without* sudo): + + ``python3 install.py`` + + The program sudo may prompt for your administrator (root) password during the + install process, if required. + + For a list of optional commands you can give the insaller, run: + + ``python3 install.py --help`` + + 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``. + + Supported Linux Versions + ======================== + + - Ubuntu 16.04 or newer + - LinuxMint 18 or newer + - Debian 9, unstable or testing + - Fedora 25 or newer + - openSUSE Leap 42.2 or newer + - Any distribution meeting the software requirements below + + 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: + + - Python 3.4 or greater, and its development headers + - PyQt_ 5.4 or greater + - Qt_ 5.4 or greater + - `Python gobject introspection`_ modules: + - GUdev 1.0 + - UDisks 2.0 + - GLib 2.0 + - GExiv2 0.10 + - Gst 1.0 + - Notify 0.7 + - `python-gphoto2`_ 1.4.0 or newer + - pyzmq_ + - psutil_ 3.4.2 or newer + - pyxdg_ + - Arrow_ + - dateutil_ 2.2 or newer + - exiv2_ + - ExifTool_ 0.97.4 or older (0.98 has a critical bug) + - EasyGUI_ + - Colour_ + - pymediainfo_ + - SortedContainers_ + - rawkit_: renders thumbnails from RAW images from which a thumbnail cannot be extracted using + libraw_, which is especially useful when downloading DNG files from Android phones or working + with old RAW formats. + - `Qt5 plugin for reading TIFF images`_ + - Requests_ + - intltool_ + - If using Python 3.4, these additional modules: + - typing_ + - scandir_ + + 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: + + - PyQt_ 5.4 or greater + - All `Python gobject introspection`_ modules listed above + + 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 wheel`` + + 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`` + + **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``. + + + .. _website: http://damonlynch.net/rapid + .. _Python gobject introspection: https://wiki.gnome.org/action/show/Projects/PyGObject + .. _python-gphoto2: https://github.com/jim-easterbrook/python-gphoto2 + .. _pyzmq: https://github.com/zeromq/pyzmq + .. _psutil: https://github.com/giampaolo/psutil + .. _pyxdg: https://www.freedesktop.org/wiki/Software/pyxdg/ + .. _Arrow: https://github.com/crsmithdev/arrow + .. _dateutil: https://labix.org/python-dateutil + .. _typing: https://pypi.python.org/pypi/typing + .. _scandir: https://github.com/benhoyt/scandir + .. _colorlog: https://github.com/borntyping/python-colorlog + .. _rawkit: https://github.com/photoshell/rawkit + .. _pyprind: https://github.com/rasbt/pyprind + .. _exiv2: http://www.exiv2.org/ + .. _ExifTool: http://www.sno.phy.queensu.ca/~phil/exiftool/ + .. _PyPi: https://pypi.python.org/pypi + .. _GPL3: http://www.gnu.org/licenses/gpl-3.0.en.html + .. _photographer: http://www.damonlynch.net + .. _pip: https://pip.pypa.io/en/stable/ + .. _libraw: http://www.libraw.org/ + .. _PyQt: https://riverbankcomputing.com/software/pyqt/intro + .. _EasyGUI: https://github.com/robertlugg/easygui + .. _Colour: https://github.com/vaab/colour + .. _intltool: https://freedesktop.org/wiki/Software/intltool/ + .. _Tkinter: https://wiki.python.org/moin/TkInter + .. _`Qt5 plugin for reading TIFF images`: http://doc.qt.io/qt-5/qtimageformats-index.html + .. _pymediainfo: https://github.com/sbraz/pymediainfo + .. _Qt: https://www.qt.io/ + .. _SortedContainers: http://www.grantjenks.com/docs/sortedcontainers/ + .. _Requests: http://docs.python-requests.org/ +Keywords: photo,video,download,ingest,import,camera,phone,backup,rename,photography,photographer,transfer,copy,raw,cr2,nef,arw +Platform: UNKNOWN +Classifier: Development Status :: 5 - Production/Stable +Classifier: Environment :: X11 Applications :: Qt +Classifier: Intended Audience :: End Users/Desktop +Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+) +Classifier: Operating System :: POSIX :: Linux +Classifier: Programming Language :: Python :: 3.4 +Classifier: Programming Language :: Python :: 3.5 +Classifier: Programming Language :: Python :: 3.6 +Classifier: Topic :: Multimedia :: Graphics +Classifier: Topic :: Multimedia :: Video |