6. Command line options

6.1. Basic options

--title title

Use given title as gallery title. This value will find its way to the template, and is redundant as such.

6.2. View picture options

--view-size widthxheight

Defined view picture size in pixels. View picture never exceeds width and height in picture width and height, respectively.

--view-quality quality

Define view picture quality. This value is given to picture resizing application. If resize application does not take quality value, this option is ignored.

--view-convert command

Define application to resize original picture into view picture. command may and should includes some of the following tags:

%s

Source file.

%d

Destination file

%w

Target width

%h

Target height

%q

Target quality

Do not place quotes around %s or %d, these are added automatically.

Example: --view-convert "convert %s -resize %wx%h -quality %q %d"

--view-postprocess command

Use given command to post-process view picture after resizing. For example this command can be used to strip unwanted EXIF-data from the pictures to reduce file size. Multiple commands can be given by separating them with a semicolon. All occurances of %s are expanded with the filename. Default value uses exiv2 to strip MakerNote and thumbnail data. Give empty string to disable post-processing view image.

6.3. Thumbnail options

--thumb-size widthxheight

See --view-size.

--thumb-quality quality

See --view-quality.

--thumb-convert command

See --view-convert.

--thumb-postprocess command

See --view-postprocess.

6.4. Miscellaneous options

--img-basepath URI

Define hardcoded basepath for images. This option allows to have images on external server without having to rely on .htaccess.

--list-all-files

List all files that are needed for this gallery.

--ssh-all-files host

Like --list-all-files, but prints out a full command to copy the files to remote host using ssh and tar. host can include username and path on remote host, if given in form of user@host:path, host:path, or user@host.