50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
flickrannex
|
|
=========
|
|
|
|
Hook program for gitannex to use flickr as backend
|
|
|
|
# Requirements:
|
|
|
|
python2
|
|
|
|
Credit for the flickr api interface goes to: http://stuvel.eu/flickrapi
|
|
Credit for the png library goes to: https://github.com/drj11/pypng
|
|
Credit for the png tEXt patch goes to: https://code.google.com/p/pypng/issues/detail?id=65
|
|
|
|
# Install
|
|
Clone the git repository in your home folder.
|
|
|
|
git clone git://github.com/TobiasTheViking/flickrannex.git
|
|
|
|
This should make a ~/flickrannex folder
|
|
|
|
# Setup
|
|
Make the file executable, and link it into PATH
|
|
|
|
cd ~/flickrannex; chmod +x git-annex-remote-flickr; sudo ln -sf `pwd`/git-annex-remote-flickr /usr/local/bin/git-annex-remote-flickr
|
|
|
|
# Commands for gitannex:
|
|
|
|
USERNAME="username@provider.com" git annex initremote flickr type=external externaltype=flickr encryption=shared folder=gitannex
|
|
|
|
An oauth authentication link should now be launched in the default browser. The hook will wait for 30s for you to login and authenticate.
|
|
|
|
git annex describe dropbox "the flickr library"
|
|
|
|
# Notes
|
|
|
|
## Unencrypted mode
|
|
The photo name on flickr is currently the GPGHMACSHA1 version.
|
|
|
|
## Encrypted mode
|
|
The current version base64 encodes all the data, which results in ~35% larger filesize.
|
|
|
|
## Including directories as tags
|
|
This feature is currently disabled, if it gets implemented again it will most likely not require user action to enable it.
|
|
|
|
In this case the image:
|
|
/home/me/annex-photos/holidays/2013/Greenland/img001.jpg
|
|
would get the following tags: "holidays" "2013" "Greenland"
|
|
(assuming "/home/me/annex-photos" is the top level in the annex...)
|
|
|
|
Caveat Emptor - Tags will *always* be NULL for indirect repos - we don't (easily) know the human-readable file name.
|