Find file
Fetching contributors…
Cannot retrieve contributors at this time
104 lines (80 sloc) 3.32 KB


It seems there is already a program called FlickrSync in the M$ Windows realm. I guess I will need to come up with a new name at some point.

A python script to mirror flicker images and metadata. A second script to create a standalone HTML slideshow from the mirror browseable via file:///

FlickrSync - mirror a flickr user's images to a folder

FlickrSync - a python script to download all your photos from flickr along with descriptions and comments in xml. Saves the download into a folder organised into sub-folders by set.

Once downloaded, the --recent-updates option can be used to get the download up to date.

When run for the first time, the script needs to be able to start a browser for the first handshake with flickr.

Usage [options] destinationFolder


  -h, --help            show this help message and exit
  -s SETIDS, --setids=SETIDS
                        Do specified numeric set IDs only.
  -r RECENT_UPDATES, --recent-updates=RECENT_UPDATES
                        Find updates newer than N days old. -1 for updates
                        newer than the last run time
  -f, --include-favourites
                        Download favourites (in available size only).
  -X, --exclude-metadata
                        Do not download descriptions, etc as xml.
  -L, --no-links        Do not use file UNIX links, copy files instead.
                        (For images in more than one set.)


Doesn't track/update when images are removed from sets/flickr.

FlickrShow - create an HTML slideshow for a mirror

Create a slideshow sub-folder inside a mirror folder. Currently the slideshow is based on a modified version of the Responisive Image Gallery:

Dendencies on the slideshow are minimal, it would be easy to plug in different Javascript slide show templates - they all seem to function in a similar way.

Usage [options] templateFolder imageFolder


  -h, --help            show this help message and exit
  -r, --replace         Replace existing slide-show sub-folder in mirrorFolder
  -n SHOWNAME, --slide-show-name=SHOWNAME
                        Name for the slide show folder within the


  1. Create a folder to store the mirror: mkdir /home/michael/FlickrMirror

  2. Download your flickr images:

   python /home/michael/FlickrMirror/

On the first run the script will open a browser window to obtain permission to download from flickr. Once you have granted permission, return to window running the script and press return to continue with the script.

All your images and meta data will be downloaded to the specified folder.

  1. Download the ResponsiveImageGallery zip from:
  1. Setup a template ResponsiveImageGallery and copy in the template:
   cp ResponsiveTemplate.html ResponsiveImageGallery/template.html
  1. Run flickrshow:
   python ResponsiveImageGallery/ /home/michael/FlickrMirror
  1. Browse the slideshow URL: