Fotopic Backup Tool For Perl Geeks

The following program will download your entire Fotopic gallery to your local drive.

If you are looking for a more 'user friendly' way of downloading your Fotopic galleries, you should look here for the nice happy friendly version for people who can't drive a command line.

Things it does do:

• Download all your original files in the format "galleryname/yyyy-mm-dd collectionname/blah.jpg".
• Save photo description and metadata in XML, CSV or descript.ion format.
• Run in 'fill in the gaps' mode, so you can maintain a local copy without messing around downloading the whole lot.
• Store counter values and time the counter snapshot was taken.
• Do it cleanly, simply, and quickly.

Things it doesn't do (yet):

• Check for available disk space.
• Store gallery comments and overall gallery metadata.

Comments and notes to Joel please.

A gzip of the perl script is available:

• Perl script - this is not for the faint hearted but allows cron-able cmd-line download of galleries.

This is unsupported and provided as-is. Your mileage may of course vary.

NOTICE: No guarantees implied, not my responsibility, you run it at your own risk.

Dependencies

This script relies on a few perl modules being installed. They are:

Date::Parse
LWP
Digest::MD5
XML::Simple

You can obtain them from CPAN.

If you're using Ubuntu Karmic Koala (9.10) or Debian Lenny (at least), you can get all the relevant perl libraries by using apt-get to obtain the following packages:

libdatetime-format-natural-perl
libdigest-md5-file-perl
libxml-simple-perl
libwww-perl

I understand the packages are different for Ubuntu Hardy, and will of course be different for other packages. If in doubt, just install the CPAN modules although if you grok perl then you'll know that already, won't you ;)

Anyway, if you see 'unknown method' errors, you've probably not got those installed. Alternatively this list has gone out of date, but that's fairly unlikely.

Usage

fpbackup.pl --username=blah@blah.com --password=mypassword

If no gallery URL is given, will download all galleries you have access to.

Mandatory:
  --username=<username>      Username to access API (Fotopic login)
  --password=<password>      Password to access API (Fotopic password)

Optional:
  --force                    Force download of images regardless
  --verbose                  Print extra data on fetch process
  --galleryid=<gid>          Download a particular gallery by ID
  --gallery=<hostname>       Download a particular gallery by hostname
  --destdir=<dir>            Put files in destination dir specified

Metafile (database) options:
  --description              Create descript.ion files as used on ACDSee
  --metafile                 Create CSV metafile for each collection
  --metaxml                  Create XML metafile for each collection

Changelog

0.3 (2010-03-10):

• Oops, make_path is deprecated. Replaced with mkpath.

0.2 (2010-03-10):

• Added counter and equipment archival.
• Deals with bad characters in descriptions better.
• Added metadata.xml and metadata.csv output.
• Added descript.ion.

0.1 (2010-03-09):

• Initial version.

© 2010 Joel Rowbottom