DRC Device configuration

Digital recording devices are voice recorders and cameras. Many modern cameras include voice recorders. Cameras often support multiple picture taking modes including still, video, action sequences, panoramic shots, and other specialized types. Multiple entries may be required to retrieve all the files from various locations.

Each configured device begins with a line which begins with "device: " followed by a name for the device.

After that are lines containing the parameters which describe the file names that the device creates on its flash card. These lines are indented by one space character, followed by a keyword, another space character, and then an appropriate value for that keyword. The following chart defines the allowable keywords and values.

Keyword	Value
path	Atop level directory name under which all files of interest are stored. If the entry contains '/'characters, it describes a multiple level directory structure. Each level may be a perl pattern that doesn't contain '/' characters, which matches the path from the root directory of the drive, down to the actual files to be copied. Note that each pattern for each directory should be "anchored" with a leading ^ and trailing $ to ensure that the whole directory name is matched, if that is the intention (and it generally should be). And the reason to use / to divide the patterns is that it is a character than is illegal in file names, it is the alternate path separator on Windows, besides \, and \ gets used in lots of regular expressions, so using / for the separator makes things easier.
file	A perl pattern describing the names of the files of interest.
extraname	A text string that is included as part of the name of the renamed files.
sequence	No value. The existance of the keyword flags that a sequence number should be included as part of the name of the renamed files.
noclock	No value. The existance of the keyword flags that there is no timestamp on or in the files, due to the lack of a clock on the device. The date the files are copied is included in the name, in lieu of the usual timestamp. Generally, to obtain uniqueness, it is good to use the sequence keyword along with the noclock keyword.
extrapath	No value. The existance of the keyword flags that the last component of the path should be used as a newly created directory in the target directory for the files copied for this configuration.
ext	A text string that is included as part of the name of the extrapath when it is used. Can be used to identify particular cameras if multiple cameras of different types are used.
pre-rename	If no rename rule is specified, the following extended Perl substitution pattern is used: /^.*([.][^.]+)$/`d-`t`i\L$1/ In other words, the root is replaced with the date-time and id, and the the extension is lowercased. Various options adjust this basic pattern, such as sequence, annotation, and extraname adjust that substitution in various ways. pre-rename allows a device-specific opportunity to rework the names before the standard substitution is applied. post-rename allows a device-specific opportunity to adjust the names after the standard substitution is applied. This syntax here is the match pattern, then a / character, then the replacement pattern. The leading and trailing / for the Perl substitution syntax are optional.
post-rename
thumbpath	An adjustment to the path where pictures are found to obtain the path where thumbnails are found. This only exists to support the Vivitar Vivicam 2800, among cameras I have seen. Perhaps other models used a similar filesystem. The only support for thumbnails, if they exist, is deleting them. Thumbnails can be regenerated in a more appropriate size and quality on the computer. If this rule isn't good enough for some camera, additional rules will have to be invented.

Wallet configuration

A digital wallet is defined as a file structure that may contain multiple intsances of the file structures from other recording devices. Devices exist with large capacity storage (compared to those for the recording device) and the ability to copy the files from the device in some manner, allowing reuse of the (more portable) memory units (flash cards) for the device. One example would be a flash-card-reader-CD-writer that would capture one or more flash cards to a multisession CD. Other units are hard-disk based, and have higher capacities (but are also more fragile).

Each configured wallet begins with a line which begins with "wallet: " followed by a name for the wallet.

After that are lines containing the parameters which describe the file names that the device creates on its flash card. These lines are indented by one space character, followed by a keyword, another space character, and then an appropriate value for that keyword. The following chart defines the allowable keywords and values.

Keyword	Value
path	Similar to path for devices, but describes the file structure from the root directory of the wallet to the top level of the saved device file structures. Hence the complete path to the files is composed of (wallet path)/(device path).