DIGICAMSYNC

NAME

SYNOPSIS

DESCRIPTION

After copying the files, you can delete the copied files from the camera leaving others untouched (e.g. if you also use your digicam as a USB mass storage device), delete all files in the specified directory or exit without deleting anything.

The default configuration is stored in ~/.digicamsync. At the first start, a generic configuration file will be created (with the parameters to be used with an Olympus C-417 Camera).
You can create several configuration files and source them via the [--cfg_file | -c] option so you can use different cameras without having to change the configuration. All entries in a configuration file can also be passed to digicamsync via command line option (e.g. --mount_cmd="some command").
First, default values are set in case there's no configuration file. Then, a configuration file is sourced (~/.digicamsync if the --cfg_file option is not set). At last, the options of the command line are parsed.  

OPTIONS

Operation options

--pic_dir, -d directory

The directory that will be created for the photos. If given, digicamsync won't prompt for a directory name.

--cfg_file, -c file

Load the configuration file file instead of the default ~/.digicamsync

--tempcopy, -t

Same as --batch --pic_dir_rename="%f" --pic-dir=<tmpdir>

--batch, -b

Don't prompt for anything. If --pic_dir isn't given, the value of --tmpdir is created as a directory. If that directory already exists, a consecutive number is automatically appended so that a directory with this name can be created.
After copying, digicamsync just exits without deleting anything unless the --delete_copied option is set.

--delete_copied

When copying is finished and all files have been copyied successfully, delete the copied files without asking.

--no_delete, -n

Don't delete any files and don't ask if anything should be deleted.

--overwrite

When a file exists that has the name a copyied file should get, replace this file. Normally, no files are overwritten.

--info, -i

Just display information about the media found on the digicam.

--nocolor

Don't use colored output.

--help, -?

Display the help dialog of digicamsync.

Values stored in the default configuration file

The following values, as well as all renaming patterns, are stored in the configuration file ~/.digicamsync by default. They can all be passed on the command line and will be used instead of the configuration file values if given. If a value is omitted in the configuration file and not given on the command line, the default value will be used.

The syntax of the configuration file is key = "value", a comment is marked by a leading "#", so everything after it will be ignored. Each value set in the configuration file correlates to the according command line option with the diffenece that the options start with "--".

The follwing parameters can be either set in a configuration file or passed via command line:

cam_device

The device file for the camera. This value must be set separately because the device file doesn't have to appear obligatory in the mount command and digicamsync looks into /etc/mtab after the camera is mounted to get the mount point. Defaults to "/dev/sda1".

mount_cmd

The command for mounting the camera. Automount users may want to use "ls [mount point]" for this command. Defaults to "mount /dev/sda1".

pic_dir_cam

The directory where the pictures are stored on the camera. Defaults to /dcim/100olymp.

pic_dir_base

The directory that contains the directorys for the photos. If it doesn't exist, digicamsync tries to create it. Defaults to "~/Photos".

autodir

The directory that is created if no name is given. Defaults to "Olympus"

tmpdir

The directory that is created (resp. with an appended number) if --tempcopy is used. Defaults to "temp".

picext, movext and othersext

File extensions for photos, videos and other media files (e.g. sound files). Default to "jpg", "mov" and "wav".

chmod

Normally, the camera has a FAT or FAT32 file system that doesn't support file permissions. Therefore, digicamsync can set the permissions of the copied files. They will be changed to the mode given in chmod. This mode has to be an octal number with a leading "0". See chmod (1) for details!
If omitted, the permissions of the original file are set. If the filesystem entry in /etc/fstab for the camera is set to "auto", the permissions will normally be -rwxr--r--. The default for chmod is "0644", which will set the permissions to -rw-r--r--.

Rules for renaming the copied files

The placeholder "%%" can be used in every pattern to display a literal "%".

The following values can be set:

pic_dir_date

Format of the dates that can be used in --pic_dir_rename. With the exeption of %y, leading zeroes will be added if necessary and the upper-case letter can be used to get a value without leading zeroes (e.g. for September, %m would return "09", %M "9").

The following placeholders can be used:

%y

Year

%m

Month

%d

Day

%h

Hour

%i

Minute

%s

Second

%t

UNIX Timestamp

All of these placeholders can be used in pic_rename, mov_rename and others_rename (see below) as well. The default value of pic_dir_date is "%y-%m-%d", so that directorys are displayed in the right order automatically.

pic_dir_rename

The pattern used for naming the directory where the files are copied in.

The following placeholders can be used:

%d

The creation date of the oldest file that is copied. The format of this date is set by pic_dir_date.

%D

The creation date of the newest file that is copied. The format of this date is set by pic_dir_date.

%f

Filename prompted by digicamsync or given by --pic_dir. If no "%f" appears in the pattern for renaming the target directory, digicamsync won't prompt for a name. If a directory with the resulting name already exists, a consecutive number will be appended automatically (asking for another filename wouldn't be sensefull because the given name would'n appear in the resulting name anyway).

%[ and %]

The sequence between these two brackets will only be displayed if the first and the last date are different after being formatted. The default value for pic_dir_rename is "%d%[--%D%]--%f". In case you give "Photos" as the file name, the directory name depends on the dates of the copied files. Assuming the default setting for pic_dir_date is used and they were all taken on August 10 in 2005, it would be "2005-08-10--Photos". If they were taken from August 10 to September 5 in 2005, it would be "2005-08-10--2005-09-05--Photos".

pic_rename, mov_rename and others_rename

These pattern define how the copied files should be renamed. As you would expect it, pic_rename is for photos, mov_rename for videos and others_rename for other media files. See --picext, etc. for how to definie what digicamsync will see as photos, etc.
All sequences that can be used in pic_dir_date can also be used in the renaming patterns for copied files with the diffenece that the date of that particular file which is renamed will be used for the substitution. In Addition, the following sequences can be used:

%n

Consecutive number

%f

The original file name of the copied file without file extension

The file extension in lower case will be automatically appended. [pic|mov|others]_rename default all to "%n_%y-%m-%d".

HOMEPAGE

AUTHOR

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

Operation options

Values stored in the default configuration file

Rules for renaming the copied files

HOMEPAGE

AUTHOR