CLDownload Command Line Options Reference

/nickname=

If any albums are protected by a site-wide password, or you are specifying the ownerpassword, then the SmugMug account nickname should be specified.
Example: "/nickname=dsweet" would be the nickname for http://dsweet.SmugMug.com/

/ownerpassword=

Providing the owner's password will allow access to all content.

/sitepassword=

If any albums are protected by a site-wide password then the sitepassword must be specified in addition to the /nickname. This is not necessary if an ownerpassword is supplied.

/imagekeywords=

Specify a comma delimited list of keywords. Only images matching one of the keywords will be downloaded.
Example: "/imagekeywords=fjh,track"

/rootfolder=

Specify the existing, destination folder.
Example: "/rootfolder=c:\MySmugMugDownloads"

/converttojpeg=

Specify a value between 0 and 100. Where:
A value of 0 indicates that png files will not be converted to jpgs.
A value between 1 and 100 indicates the quality level of the jpg compression. The larger the value the larger the resulting downloaded file.
The default is 0. Example: "/converttojpeg=91"

/size=

When you post a picture to SmugMug, SmugMug makes copies of the picture at different resolutions as shown in the table below. Use the size specifier to request the resolution to download. The lower the resolution, the less time it takes to download the image. If you want to preserve the camera Exif data, you have to specify the Original resolution ("O"). If the resolution specified is not available, CLDownload will download the highest available resolution image.
Example: "/size=L" The default size is "O".

Description

Size Specifier

Pixels wide

Pixels high

MP4 Video

MPG Video

Thumbnails

T

Up to 150

Up to 150

Video320

Original

Small

S

Up to 400

Up to 300

Video320

Original

Medium

M

Up to 600

Up to 450

Video320

Original

Large

L

Up to 800

Up to 600

Video640

Original

XLarge

X

Up to 1024

Up to 768

Video960

Original

X2Large

X2

Up to 1280

Up to 960

Video1280

Original

X3Large

X3

Up to 1600

Up to 1200

Video1280

Original

Original

O

Huge

Huge

Video1920

Original

/downloadhidden=

Only applies when using the ownerpassword. Specify a 0 or 1 where:

0 = Do not download hidden images (default)
1 = Download hidden images

/downloadvideo=

Specify a 0 or 1 where:

0 = Do not download videos
1 = Download videos (default)

/createfolders=

Specify a 0, 1, or 2 where:

0 = Download all pictures to the /rootfolder=
1 = Create a sub-folder (of the /rootfolder=) for each album using the album title as the sub-folder name.
2 = Create a sub-folder (of the /rootfolder=) for each category and a sub-folder (of the Category folder) for each album.

Example: "/createfolders=0" The default is 0.

/overwrite=

Specify a 0 or 1 where:

0 = Skip the download and do not overwrite the file if it already exists on the hard drive. This is useful if a previous download was aborted and now you want to download the rest of the images in the album list.
1 = Overwrite existing files with the same name.

Example: "/overwrite=0" The default is 0.

/resize=

Specify MaxX, MaxY ,Quality, Maximize where:

MaxX = the maximum pixels wide
MaxY = the maximum pixels high
Quality = a number between 1-100 indicating the level of compression to use. The higher the Quality, the larger the resulting file size.
Maximize = 0, 1 or 2 where:

0 = do not perform any Maximizing processing. This is the option to use when the display can't be turned, like for a monitor or TV.
1 = Swap the MaxX and MaxY values for each image, if necessary, to maximize the resolution. This is useful when the destination device is an "orientation aware" display like the IPad.
2 = Rotate an image, if necessary, to maximize the resolution. This is useful when a desitination device is not "orientation aware", but can be easily turned, like a simple phone.

Results of Maximize settings. From left to right, maximize = 0, 1 ,2.


Example: "/resize= 320,200,90,1" Resize the image to 320x200, quality setting of 90, switch the x,y axis dimensions to maximize the size of the image.