A command line interface for Flickr.

0.5.0 2024-06-13 02:28 UTC


This is a command-line interface (CLI) to Flickr, written in PHP.

Build status


  • Upload photos.
  • Download photos by album or user.
  • Add checksum machine tags (MD5 or SHA1).
  • Internationalization.


Get the code and install dependencies:

git clone
cd phpflickr-cli
composer install --no-dev

Run the app:

./phpflickr-cli --help


cd /path/to/phpflickr-cli
git pull origin master
composer install --no-dev


Just run phpflickr-cli auth and follow the prompts. This will create a config.yml file containing your access codes; keep it safe.


To download photos, specify where you want them to end up and a template:

./phpflickr-cli download --dest=<path> --template=<template_name>

Download templates are sets of Twig template files, one for each of the following purposes: each photo; the path to each photo; and all photos (ordered by the path). Have a look at the included templates for more ideas on what they can do.


Add MD5 or SHA1 checksum machine tags to images:

./phpflickr-cli checksums --help

Requires authorization.




Copyright 2018 Sam Wilson. See LICENSE.txt for details.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see