davidascher / batchr Goto Github PK

proto-readme:

0) requirement: Python, probably 2.4 or later (untested with 2.3-)

1) get a flickr API & secret (see http://www.flickr.com/services/api/keys/)

2) stuff the above in two environment variables FLICKR_BATCHR_KEY and 
   FLICKR_BATCHR_SECRET

3) here are some usage patterns:

find the IDs for your sets:
    python ./batchr.py listsets

download original size images taken in 1997, place in specified directory:
    python ./batchr.py download -s o -y 1997 --base=/Volumes/BACKUP/photos        
download large-sized (-s b) images in specified set (-S ...) place in 
specified directory using a year/month/id file layout:

    python batchr.py download -S 7215XXX00 --base="set_photos" \
    --format="%(year)s/%(month_name)s/%(id)s.jpg" -s b      

download medium sized images tagged with foo taken in jan 1999:

    python batchr.py download --tag foo -y 1999 -m 1 --base="jan_99"

Note that downloads are incremental unless the -f/--force option is specified.

Other notable options to the 'download' command:
  --gui uses a GUI progress bar on OS X if CocoaDialogs has been installed
  --list lists each transaction instead of just a progress bar
  -v doesn't actually do the download

Feedback welcome on code.google.com/p/batchr or email to [email protected]