{"id":13557638,"url":"https://github.com/beaufour/flickr-download","last_synced_at":"2025-10-20T01:02:37.235Z","repository":{"id":6080186,"uuid":"7306647","full_name":"beaufour/flickr-download","owner":"beaufour","description":"Tool for downloading sets and photos from Flickr","archived":false,"fork":false,"pushed_at":"2025-03-31T20:16:22.000Z","size":946,"stargazers_count":236,"open_issues_count":10,"forks_count":66,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-06T06:47:37.262Z","etag":null,"topics":["flickr","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beaufour.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-12-24T11:59:28.000Z","updated_at":"2025-03-31T20:16:28.000Z","dependencies_parsed_at":"2023-10-03T19:09:21.272Z","dependency_job_id":"1e34817e-4e93-4af8-869f-f05c691bd38b","html_url":"https://github.com/beaufour/flickr-download","commit_stats":{"total_commits":238,"total_committers":13,"mean_commits":"18.307692307692307","dds":"0.10084033613445376","last_synced_commit":"6c293fbf3a4e9bb54196c1afc901055c0e988bf7"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beaufour%2Fflickr-download","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beaufour%2Fflickr-download/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beaufour%2Fflickr-download/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beaufour%2Fflickr-download/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beaufour","download_url":"https://codeload.github.com/beaufour/flickr-download/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249003944,"owners_count":21196794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flickr","python"],"created_at":"2024-08-01T12:04:27.791Z","updated_at":"2025-10-20T01:02:37.167Z","avatar_url":"https://github.com/beaufour.png","language":"Python","funding_links":[],"categories":["Python","python","Download utilities"],"sub_categories":["Application-specific"],"readme":"# Flickr Download\n\n## Introduction\n\n[![pre-commit](https://github.com/beaufour/flickr-download/actions/workflows/pre-commit.yml/badge.svg)](https://github.com/beaufour/flickr-download/actions/workflows/pre-commit.yml) [![test](https://github.com/beaufour/flickr-download/actions/workflows/test.yml/badge.svg)](https://github.com/beaufour/flickr-download/actions/workflows/test.yml) [![Coverage Status](https://coveralls.io/repos/github/beaufour/flickr-download/badge.svg)](https://coveralls.io/github/beaufour/flickr-download)\n\nSimple script to download a [Flickr](http://flickr.com) set.\n\nTo use it you need to get your own Flickr API key here:\n\u003chttps://www.flickr.com/services/api/misc.api_keys.html\u003e\n\n    flickr_download -k \u003capi key\u003e -s \u003capi secret\u003e -d \u003cset id\u003e\n\nIt can also list the public set ids for a given user:\n\n    flickr_download -k \u003capi key\u003e -s \u003capi secret\u003e -l \u003cuser name\u003e\n\nThe user name can be passed in as a URL, email, or user name.\n\nGet a public set using the title and id to name the downloaded files:\n\n    flickr_download -k \u003capi key\u003e -s \u003capi secret\u003e -d \u003cset id\u003e -n title_and_id\n\nDownload private or restricted photos by authorizing against the users account. (see below)\n\n## Installation\n\nTo install this script use the Python pip utility bundled with your Python distribution:\n\n    \u003e pip install flickr_download\n\n## API key\n\nGet your [Flickr API key](http://www.flickr.com/services/api/).\n\nYou can also set your API key and secret in `~/.flickr_download`:\n\n    api_key: my_key\n    api_secret: my_secret\n\n## User Authentication Support\n\nThe script also allows you to authenticate as a user account. That way you can download sets that\nare private and public photos that are restricted. To use this mode, initialize the authorization by\nrunning the script with the `t` parameter to authorize the app.\n\n    flickr_download -k \u003capi key\u003e -s \u003capi secret\u003e -t\n\nThis will save `~/.flickr_token` containing the authorization. Subsequent calls with `-t` will use the\nstored token. For example using\n\n    flickr_download -k \u003capi key\u003e -s \u003capi secret\u003e -l \u003cUSER\u003e\n\nwith _USER_ set to your own username, will only fetch your publicly available sets, whereas adding `-t`\n\n    flickr_download -k \u003capi key\u003e -s \u003capi secret\u003e -l \u003cUSER\u003e -t\n\nwill fetch all your sets including private restricted sets.\n\nNote, if you want to log in as another user delete `~/.flickr_token`.\n\n## Downloading a lot of photos\n\nIf you are downloading a lot of photos, two parameters will speed things up. Especially on errors (which the Flickr API seems to like to throw regularly). Those parameters are:\n\n* `--cache \u003ccache_file\u003e` – this will cache API responses in the given file, and will thus speed up repeated calls to the same API\n* `--metadata_store` - this will store metadata information for the set downloads in `.metadata.db`, which makes it faster to skip already downloaded files.\n\nSo to download all the sets for a given user `XXX`, including private photos and sets, do:\n\n    \u003e flickr_download -k KEY -s SECRET --user_auth --cache api_cache --metadata_store --download_user XXX\n\n## Optional arguments\n\n    -h, --help            show this help message and exit\n    -k API_KEY, --api_key API_KEY\n                            Flickr API key\n    -s API_SECRET, --api_secret API_SECRET\n                            Flickr API secret\n    -t, --user_auth       Enable user authentication\n    -l USER, --list USER  List photosets for a user\n    -d SET_ID, --download SET_ID\n                            Download the given set\n    -p USERNAME, --download_user_photos USERNAME\n                            Download all photos for a given user\n    -u USERNAME, --download_user USERNAME\n                            Download all sets for a given user\n    -i PHOTO_ID, --download_photo PHOTO_ID\n                            Download one specific photo\n    -q SIZE_LABEL, --quality SIZE_LABEL\n                            Quality of the picture. Examples: Original/Large/Medium/Small. By default the largest available is used.\n    -n NAMING_MODE, --naming NAMING_MODE\n                            Photo naming mode. Use --list_naming to get a list of possible NAMING_MODEs\n    -m, --list_naming     List naming modes\n    -o, --skip_download   Skip the actual download of the photo\n    -j, --save_json       Save photo info like description and tags, one .json file per photo\n    -c CACHE_FILE, --cache CACHE_FILE\n                            Cache results in CACHE_FILE (speed things up on large downloads in particular)\n    --metadata_store      Store information about downloads in a metadata file (helps with retrying downloads)\n    -v, --verbose         Turns on verbose logging\n    --version             Lists the version of the tool\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeaufour%2Fflickr-download","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeaufour%2Fflickr-download","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeaufour%2Fflickr-download/lists"}