.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "RAPID-PHOTO-DOWNLOADER.1 1"
.TH RAPID-PHOTO-DOWNLOADER.1 1 "2022-11-09" "rapid-photo-downloader" ""
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
rapid\-photo\-downloader \- Downloads, renames and backs up photos and videos from cameras, phones,
memory cards and other devices
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBrapid-photo-downloader\fR [options] [path]
.PP
Options:
.PP
.Vb 10
\&    \-h, \-\-help
\&    \-\-version
\&    \-\-detailed\-version
\&    \-v, \-\-verbose
\&    \-\-debug
\&    \-e, \-\-extensions
\&    \-\-photo\-renaming {on,off}
\&    \-\-video\-renaming {on,off}
\&    \-a {on,off}, \-\-auto\-detect {on,off}
\&    \-t {on,off}, \-\-this\-computer {on,off}
\&    \-\-this\-computer PATH
\&    \-\-photo\-destination PATH
\&    \-\-video\-destination PATH
\&    \-b {on,off}, \-\-backup {on,off}
\&    \-\-backup\-auto\-detect {on,off}
\&    \-\-photo\-backup\-identifier FOLDER
\&    \-\-video\-backup\-identifier FOLDER
\&    \-\-photo\-backup\-location PATH
\&    \-\-video\-backup\-location PATH
\&    \-\-ignore\-other\-photo\-file\-types
\&    \-\-auto\-download\-startup {on,off}
\&    \-\-auto\-download\-device\-insertion {on,off}
\&    \-\-thumbnail\-cache {on,off}
\&    \-\-delete\-thumbnail\-cache
\&    \-\-forget\-remembered\-files
\&    \-\-import\-old\-version\-preferences
\&    \-\-reset
\&    \-\-log\-gphoto2
\&    \-\-camera\-info
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBRapid Photo Downloader\fR 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.
.PP
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.
.PP
Files are downloaded from two different types of sources: (1) one or more
automatically detected devices like cameras, phones, memory cards, and external
drives; and (2) a single manually specified path, shown in the user interface as
\&\*(L"This Computer\*(R".
.SH "PATH"
.IX Header "PATH"
Optional value that when specified, is parsed to determine if it represents an
automatically detected device or a path on this computer.
.PP
If the path represents an automatically detected device, automatic detection of
devices is turned on, as in the \fB\-\-auto\-detect\fR option. Furthermore, downloading from a manually
specified path as in the \fB\-\-this\-computer\-location\fR option is turned off.
.PP
Otherwise, the path is assumed to be a manually specified path as in the
\&\fB\-\-this\-computer\-location\fR option, in which case downloading from this computer is turned on
and downloading from automatically detected devices is turned off.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-h, \-\-help\fR" 4
.IX Item "-h, --help"
Show help message and exit.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Displays information about the currently installed version and exits.
.IP "\fB\-\-detailed\-version\fR" 4
.IX Item "--detailed-version"
Displays information about the currently installed version and its libraries and exits.
.IP "\fB\-v, \-\-verbose\fR" 4
.IX Item "-v, --verbose"
Displays program information on the command line as the program runs.
.IP "\fB\-\-debug\fR" 4
.IX Item "--debug"
Displays debugging information on the command line as the program runs
.IP "\fB\-e, \-\-extensions\fR" 4
.IX Item "-e, --extensions"
Displays image file extensions the program recognizes and exits.
.IP "\fB\-\-photo\-renaming {on,off}\fR" 4
.IX Item "--photo-renaming {on,off}"
Turn on or off the the renaming of photos while downloading,
overwriting existing program preferences. If turned on,
the renaming scheme used will incorporate the photo's metadata date, time,
the number of downloads today, and the file extension in lower case:
\&\f(CW\*(C`YYYYMMDD\-HHMM\-<DownloadsToday>.<LowercaseExtension>\*(C'\fR,
e.g. 20160512\-1309\-23.jpg.
.IP "\fB\-\-video\-renaming {on,off}\fR" 4
.IX Item "--video-renaming {on,off}"
Turn on or off the the renaming of videos while downloading,
overwriting existing program preferences. If turned on,
the renaming scheme used will incorporate the video's metadata date, time,
the number of downloads today, and the file extension in lower case:
\&\f(CW\*(C`YYYYMMDD\-HHMM\-<DownloadsToday>.<LowercaseExtension>\*(C'\fR,
e.g. 20160512\-1429\-26.mp4.
.IP "\fB\-a {on,off}, \-\-auto\-detect {on,off}\fR" 4
.IX Item "-a {on,off}, --auto-detect {on,off}"
Turn on or off the automatic detection of devices from which to download, 
overwriting existing program preferences.
.IP "\fB\-t {on,off}, \-\-this\-computer {on,off}\fR" 4
.IX Item "-t {on,off}, --this-computer {on,off}"
Turn on or off downloading from this computer (see description above),
overwriting existing program preferences.
.IP "\fB\-\-this\-computer\-location \s-1PATH\s0\fR" 4
.IX Item "--this-computer-location PATH"
The \s-1PATH\s0 on this computer from which to download, overwriting existing program 
preferences.
.IP "\fB\-\-photo\-destination \s-1PATH\s0\fR" 4
.IX Item "--photo-destination PATH"
Sets the \s-1PATH\s0 where photos will be downloaded to, overwriting existing program
preferences.
.IP "\fB\-\-video\-destination \s-1PATH\s0\fR" 4
.IX Item "--video-destination PATH"
Sets the \s-1PATH\s0 where videos will be downloaded to, overwriting existing program
preferences.
.IP "\fB\-b {on,off}, \-\-backup {on,off}\fR" 4
.IX Item "-b {on,off}, --backup {on,off}"
Turns on or off the backing up of photos and videos while downloading, overwriting
existing program preferences.
.IP "\fB\-\-backup\-auto\-detect {on,off}\fR" 4
.IX Item "--backup-auto-detect {on,off}"
Turns on or off the automatic detection of backup devices, overwriting
existing program preferences.
.IP "\fB\-\-photo\-backup\-identifier \s-1FOLDER\s0\fR" 4
.IX Item "--photo-backup-identifier FOLDER"
Sets the \s-1FOLDER\s0 in which backups are stored on the automatically detected photo backup 
device, with the folder's name being used to identify whether or not the device
is used for backups. For each device you wish to use for backing up photos to, 
create a folder on it with this name. Overwrites existing program preferences.
.IP "\fB\-\-video\-backup\-identifier \s-1FOLDER\s0\fR" 4
.IX Item "--video-backup-identifier FOLDER"
Sets the \s-1FOLDER\s0 in which backups are stored on the automatically detected video backup 
device, with the folder's name being used to identify whether or not the device
is used for backups. For each device you wish to use for backing up videos to, 
create a folder on it with this name. Overwrites existing program preferences.
.IP "\fB\-\-photo\-backup\-location \s-1PATH\s0\fR" 4
.IX Item "--photo-backup-location PATH"
Sets the \s-1PATH\s0 where photos will be backed up when automatic detection of backup devices
is turned off. Overwrites existing program preferences.
.IP "\fB\-\-video\-backup\-location \s-1PATH\s0\fR" 4
.IX Item "--video-backup-location PATH"
Sets the \s-1PATH\s0 where videos will be backed up when automatic detection of backup devices
is turned off. Overwrites existing program preferences.
.IP "\fB\-\-ignore\-other\-photo\-file\-types\fR" 4
.IX Item "--ignore-other-photo-file-types"
Do not download photos with the following extensions: \s-1TIF, TIFF\s0 and \s-1MPO.\s0
.IP "\fB\-\-auto\-download\-startup {on,off}\fR" 4
.IX Item "--auto-download-startup {on,off}"
Turns on or off starting downloads as soon as the program itself starts.
.IP "\fB\-\-auto\-download\-device\-insertion {on,off}\fR" 4
.IX Item "--auto-download-device-insertion {on,off}"
Turns on or off starting downloads as soon as a device is inserted.
.IP "\fB\-\-thumbnail\-cache {on,off}\fR" 4
.IX Item "--thumbnail-cache {on,off}"
Turns on or off use of the Rapid Photo Downloader Thumbnail Cache. Turning it off does not
delete existing cache contents.
.IP "\fB\-\-delete\-thumbnail\-cache\fR" 4
.IX Item "--delete-thumbnail-cache"
Deletes all thumbnails in the Rapid Photo Downloader Thumbnail Cache, and exits.
.IP "\fB\-\-forget\-remembered\-files\fR" 4
.IX Item "--forget-remembered-files"
Forgets which files have been previously downloaded, and exits.
.IP "\fB\-\-import\-old\-version\-preferences\fR" 4
.IX Item "--import-old-version-preferences"
Imports preferences from an old program version (0.4.11 or earlier), and exits. Requires the
command line program gconftool\-2.
.IP "\fB\-\-reset\fR" 4
.IX Item "--reset"
Resets all program settings to their default values, deletes all thumbnails in the Thumbnail
cache, forgets which files have been previously downloaded, and exits.
.IP "\fB\-\-log\-gphoto2\fR" 4
.IX Item "--log-gphoto2"
Includes gphoto2 debugging information in log files, which can be useful when analyzing
any problems libgphoto2 might have accessing a camera.
.IP "\fB\-\-camera\-info\fR" 4
.IX Item "--camera-info"
Print information to the terminal about attached cameras and exit.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
If the environment variable \s-1RPD_SCAN_DEBUG\s0 is set to any value, the program's scan
operation will output voluminous debug information to stdout.
.PP
If the environment variable \s-1RPD_DEVEL_DEFAULTS\s0 is set to any value, the program's default
preferences will be set to those of a development environment.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBanalyze\-pv\-structure\fR\|(1)
.SH "AUTHORS"
.IX Header "AUTHORS"
\&\fBRapid Photo Downloader\fR was written by Damon Lynch <damonlynch@gmail.com>.
.PP
This manual page was written by Damon Lynch.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
This program is free software; you can redistribute it and/or modify it
under the terms of the \s-1GNU\s0 General Public License as published by the
Free Software Foundation; either version 3, or (at your option) any
later version.
.PP
On Debian GNU/Linux systems, the complete text of the \s-1GNU\s0 General
Public License can be found in `/usr/share/common\-licenses/GPL'.