summaryrefslogtreecommitdiff
path: root/doc/tips/flickrannex.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'doc/tips/flickrannex.mdwn')
-rw-r--r--doc/tips/flickrannex.mdwn37
1 files changed, 25 insertions, 12 deletions
diff --git a/doc/tips/flickrannex.mdwn b/doc/tips/flickrannex.mdwn
index 47d834177..d8e54b4c3 100644
--- a/doc/tips/flickrannex.mdwn
+++ b/doc/tips/flickrannex.mdwn
@@ -1,3 +1,4 @@
+# Latest version 0.1.10
Hook program for gitannex to use flickr as backend.
This allows storing any type of file on flickr, not only images and movies.
@@ -10,7 +11,7 @@ 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
+# Install
Clone the git repository in your home folder.
@@ -18,7 +19,7 @@ Clone the git repository in your home folder.
This should make a ~/flickrannex folder
-## Setup
+# Setup
Run the program once to set it up.
@@ -26,24 +27,36 @@ Run the program once to set it up.
After the setup has finished, it will print the git-annex configure lines.
-## Configuring git-annex
+# Configuring git-annex
git config annex.flickr-hook '/usr/bin/python2 ~/flickrannex/flickrannex.py'
git annex initremote flickr type=hook hooktype=flickr encryption=shared
git annex describe flickr "the flickr library"
-## Notes
+# Notes
-### Unencrypted mode
+## Unencrypted mode
+The photo name on flickr is currently the GPGHMACSHA1 version.
-The photo name on flickr is currently the [[key|backends]] used by git-annex.
+Run the following command in your annex directory
+ git annex wanted flickr uuid include=*.jpg or include=*.jpeg or include=*.gif or include=*.png
-### Encrypted mode
+## Encrypted mode
+The current version base64 encodes all the data, which results in ~35% larger filesize.
-The current version base64 encodes all the data, which results in ~35%
-larger filesize.
+I might look into yyenc instead. I'm not sure if it will work in the tEXt field.
-I might look into yyenc instead. I'm not sure if it will work in the tEXt
-field.
+Run the following command in your annex directory
+ git annex wanted flickr exclude=largerthan=30mb
--- Tobias
+## Including directories as tags
+Get get each of the directories below the top level git directory added as tags to uploads:
+
+ git config annex.flickr-hook 'GIT_TOP_LEVEL=`git rev-parse --show-toplevel` /usr/bin/python2 %s/flickrannex.py'
+
+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.