Download photos from Flickr
Project description
# Introduction
[![Build Status](https://travis-ci.org/beaufour/flickr-download.svg)](https://travis-ci.org/beaufour/flickr-download)
Simple script to download a [Flickr](http://flickr.com) set.
To use it you need to get your own Flickr API key here:
https://www.flickr.com/services/api/misc.api_keys.html
flickr_download -k <api key> -s <api secret> -d <set id>
It can also list the public set ids for a given user:
flickr_download -k <api key> -s <api secret> -l <user name>
Get a public set using the title and id to name the downloaded files:
flickr_download -k <api key> -s <api secret> -d <set id> -n title_and_id
Download private or restricted photos by authorising against the users account. (see below)
# Installation
To install this script use the Python pip utility bundled with your Python distribution:
pip install flickr_download
# API key
Get your [Flickr API key](http://www.flickr.com/services/api/).
You can also set your API key and secret in `~/.flickr_download`:
api_key: my_key
api_secret: my_secret
# User Authentication Support
The script also allows you to authenticate as a user account. That way you can download sets that
are private and public photos that are restricted. To use this mode, initialise the authorisation by
running the script with the `t` parameter to authorize the app.
flickr_download -k <api key> -s <api secret> -t
This will save `.flickr_token` containing the authorisation. Subsequent calls with `-t` will use the
stored token. For example using
flickr_download -k <api key> -s <api secret> -l <USER>
with _USER_ set to your own username, will only fetch your publicly available sets, whereas adding `-t`
flickr_download -k <api key> -s <api secret> -l <USER> -t
will fetch all your sets including private restricted sets.
# Requirements
* [argparse](http://docs.python.org/2.7/library/argparse.html) (Python 2.7+)
* [Python Dateutil](http://labix.org/python-dateutil)
* [Python Flickr API](https://github.com/alexis-mignon/python-flickr-api/)
* [PyYAML](http://pyyaml.org/)
# Optional arguments
```
-h, --help show this help message and exit
-k API_KEY, --api_key API_KEY
Flickr API key
-s API_SECRET, --api_secret API_SECRET
Flickr API secret
-t, --user_auth Enable user authentication
-l USER, --list USER List photosets for a user
-d SET_ID, --download SET_ID
Download the given set
-p USERNAME, --download_user_photos USERNAME
Download all photos for a given user
-u USERNAME, --download_user USERNAME
Download all sets for a given user
-i PHOTO_ID, --download_photo PHOTO_ID
Download one specific photo
-q SIZE_LABEL, --quality SIZE_LABEL
Quality of the picture
-n NAMING_MODE, --naming NAMING_MODE
Photo naming mode
-m, --list_naming List naming modes
-o, --skip_download Skip the actual download of the photo
```
[![Build Status](https://travis-ci.org/beaufour/flickr-download.svg)](https://travis-ci.org/beaufour/flickr-download)
Simple script to download a [Flickr](http://flickr.com) set.
To use it you need to get your own Flickr API key here:
https://www.flickr.com/services/api/misc.api_keys.html
flickr_download -k <api key> -s <api secret> -d <set id>
It can also list the public set ids for a given user:
flickr_download -k <api key> -s <api secret> -l <user name>
Get a public set using the title and id to name the downloaded files:
flickr_download -k <api key> -s <api secret> -d <set id> -n title_and_id
Download private or restricted photos by authorising against the users account. (see below)
# Installation
To install this script use the Python pip utility bundled with your Python distribution:
pip install flickr_download
# API key
Get your [Flickr API key](http://www.flickr.com/services/api/).
You can also set your API key and secret in `~/.flickr_download`:
api_key: my_key
api_secret: my_secret
# User Authentication Support
The script also allows you to authenticate as a user account. That way you can download sets that
are private and public photos that are restricted. To use this mode, initialise the authorisation by
running the script with the `t` parameter to authorize the app.
flickr_download -k <api key> -s <api secret> -t
This will save `.flickr_token` containing the authorisation. Subsequent calls with `-t` will use the
stored token. For example using
flickr_download -k <api key> -s <api secret> -l <USER>
with _USER_ set to your own username, will only fetch your publicly available sets, whereas adding `-t`
flickr_download -k <api key> -s <api secret> -l <USER> -t
will fetch all your sets including private restricted sets.
# Requirements
* [argparse](http://docs.python.org/2.7/library/argparse.html) (Python 2.7+)
* [Python Dateutil](http://labix.org/python-dateutil)
* [Python Flickr API](https://github.com/alexis-mignon/python-flickr-api/)
* [PyYAML](http://pyyaml.org/)
# Optional arguments
```
-h, --help show this help message and exit
-k API_KEY, --api_key API_KEY
Flickr API key
-s API_SECRET, --api_secret API_SECRET
Flickr API secret
-t, --user_auth Enable user authentication
-l USER, --list USER List photosets for a user
-d SET_ID, --download SET_ID
Download the given set
-p USERNAME, --download_user_photos USERNAME
Download all photos for a given user
-u USERNAME, --download_user USERNAME
Download all sets for a given user
-i PHOTO_ID, --download_photo PHOTO_ID
Download one specific photo
-q SIZE_LABEL, --quality SIZE_LABEL
Quality of the picture
-n NAMING_MODE, --naming NAMING_MODE
Photo naming mode
-m, --list_naming List naming modes
-o, --skip_download Skip the actual download of the photo
```
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
flickr_download-0.2.20.tar.gz
(8.0 kB
view hashes)
Built Distribution
Close
Hashes for flickr_download-0.2.20-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | db2c47cd287a0cad8b0744226f8bc087d301f63938da62dd6da003e1f38f3438 |
|
MD5 | 1ee05ea29622908bfe29bde16d3f965a |
|
BLAKE2b-256 | eacf68eb7614071aed9dd4601bc529adce07cc0a358f1609d6cfda1a29f8290b |