summaryrefslogtreecommitdiff
path: root/doc/tips/flickrannex.mdwn
blob: 47d834177d49d5693befafa34d5306a65d9765c3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
Hook program for gitannex to use flickr as backend.

This allows storing any type of file on flickr, not only images and movies.

# 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

Run the program once to set it up. 

    cd ~/flickrannex; python2 flickrannex.py

After the setup has finished, it will print the git-annex configure lines.

## 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

### Unencrypted mode

The photo name on flickr is currently the [[key|backends]] used by git-annex.

### Encrypted mode

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.

-- Tobias