parallel-flickr is a tool for backing up your Flickr photos and generating a database backed website that honours the viewing permissions you've chosen on Flickr. parallel-flickr is not a replacement for Flickr.

parallel-flickr is still a work in progress. It ain't pretty or classy yet but it works. It almost certainly still contains bugs, some of them really stupid.

It still needs to be documented properly.

In the meantime, here's a blog post and some screenshots.

These instructions are incomplete. They'll probably work but I have tested them from scratch yet. The following assumes you're running on a brand new vanilla Ubuntu machine.

• First, some basic OS-level setup:

  $> sudo apt-get install git-core

  $> git clone [email protected]:straup/parallel-flickr.git

  $> cd parallel-flickr

  $> sudo sh ./ubuntu/install.sh

  $> sudo chown -R www-data templates_c

  TO DO: apache configs

  $> cd schema

  $> mysql -u root -p < SETUP.md

  $> cat *schema | mysql -u root -p flickr

• Now set up the application config file:

  $> cp www/include/config.php.example www/include/config.php

  TO DO: updating the config file, see also: https://github.com/straup/flamework-tools/blob/master/bin/make-project.sh

• That's it.

After setting up everything above, and setting your API key callback to "http://YOURDOMAINNAME.com/auth/", visit /account/backups/. This will create your backup user account and then from here you can run the various backup scripts inside of the bin/ directory.

It is helpful to set these various bin/backup_* scripts to run via cron. According to your level of faving, uploading, and contacts fiddling, you may have your own requirements for often you want to run the various backup scripts.

Here's my a once-a-day example, which works for a moderate level of activity:

0 3 * * * php /full/path/to/parallel-flickr/bin/backup_contacts.php
15 3 * * * php /full/path/to/parallel-flickr/bin/backup_faves.php
30 3 * * * php /full/path/to/parallel-flickr/bin/backup_photos.php

• make sure video files are actually being fetched properly

• sets, galleries, groups

• people tagging (http://www.flickr.com/services/api/flickr.photos.people.getList.html)

• uploads (and then re-uploading to Flickr

• dates and timezones... sad face

• photo deletion

• account deletion

• context-specific URLs (e.g. in-faves or in-WOEID)

• display metadata

• search

• better layout, tested in more than just Firefox

• send to Internet Archive (http://www.archive.org/help/abouts3.txt)

See also: TODO.txt

• password reminders are disabled, only because I don't have a mail server set up

If you look carefully you may see that there are a lot branches for parallel-flickr in my Github repository. These are there purely (and only) for my working purposes.

You're welcome to poke at them obviously but the rule of thumb is: If it's in "master" then it should work, modulo any outstanding bugs. If it's in any other branch then all the usual caveats apply, your mileage may vary and we offer no guarantees or refunds.

• flamework

• flamework-flickrapp

• flamework-api

• flamework-invitecodes

• flamework-tools