flickrsync 0.1.0rc8

A command line tool to synchronise pictures between the local file system and Flickr

A command line tool to synchronise pictures between the local file system and Flickr

https://github.com/danchal/flickrsync

https://pypi.python.org/pypi/flickrsync

Requirements

Python3
Wand
A Flickr account

Install

$ sudo apt install python3-wand
$ sudo pip3 install flickrsync

For Windows / Mac installation help:

http://docs.wand-py.org/en/0.4.4/guide/install.html

References

https://pypi.python.org/pypi/flickrapi

https://pypi.python.org/pypi/Wand

https://pypi.python.org/pypi/configparser

http://www.imagemagick.org

https://www.flickr.com/

Setup

1. Edit the configuration file

   • configuration file is created during the pip installation

   • location will be somewhere in your python library ../flickrsync/etc/config.ini

   • add your Flickr username, API Key and API Secret

   • edit your pictures directory as required

2. Authenticate the FlickrSync application with Flickr (see usage, below)

Usage

To see a list of commands
$ flickrsync --help

To authenticate FlickrSync with Flickr
$ flickrsync --auth

To perform a one way sync from the local file system to Flickr
$ flickrsync --sync

To perform a two way sync between the local file system and Flickr
$ flickrsync --sync2

To create Flickr photosets based upon the local file system
$ flickrsync --photosets

Features

1. Duplicate copies of the same picture on the local file system are identified.

   • Image hash signature of the picture is used

   • only a single copy of the picture will be uploaded

2. Does not rely on the local pathname for identifying the picture.

   • moving a picture to a different directory will not cause the picture to be uploaded again

3. A SQLite database is used to index local and Flickr pictures.

   • destroying the database will not result in any pictures being uploaded again

   • database is automatically recreated

4. Perform a two way sync between the local file system and Flickr.

Sync Process

Local <==> Flickr

1. Creates an index of pictures on the local file system.

2. Creates an index of pictures on Flickr.

3. Identify duplicate pictures on local file system.

4. Match local pictures to Flickr.

5. Download and scan unmatchable Flickr pictures.

6. Upload unmatched local pictures to Flickr.

7. Download pictures from Flickr that are missing on the local file system.

8. Create Flickr photosets based upon the original filepath of the picture.

Picture Matching

Local	Flickr
DateTimeOriginal	Filename	Signature	DateTakenUnknown	DateTaken	Title	Signature	Match
x	x		0	x	x		yes
		x				x	yes

Note: x indicates a match betwen local and Flickr

1. Pictures will be matched by either:-

   • picture file name + date picture was taken, or

   • ImageMagick hash signature of picture

2. Each uploaded picture is tagged with its ImageMagick hash signature.

3. Pictures on Flickr have a datetaken, https://www.flickr.com/services/api/misc.dates.html.

4. If the Flickr datetaken is generated from the pictures Exif data, then Flickr will set the DateTakenUnknown to 0.

5. If it exists, the Exif DateTimeOriginal is extracted from each picture on the local file system.

6. The Flickr title is based upon the original filename of the uploaded picture.

7. File names are compared without the file extension. This is because Flickr does not always maintain the file extension during upload as it is dependent upon the upload client used.

Photosets

1. A photoset is based upon a flattened directory path of each picture.

2. Photosets created by FlickrSync are identified as such by their photoset description.

   • (re)creating the photosets could delete any photosets that are not being used

   • only photosets previously created by FlickrSync are deleted

Notes

1. FlickrSync does NOT require sudo to run.

2. Pictures will not be deleted on either the local file system or Flickr.