PHPackages thefox/flickr-cli - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. thefox/flickr-cli ActiveProject[CLI & Console](/categories/cli) thefox/flickr-cli ================= Upload and download Flickr photos, photo sets, directories via shell. v2.0.3(8y ago)27159[11 issues](https://github.com/TheFox/flickr-cli/issues)[5 PRs](https://github.com/TheFox/flickr-cli/pulls)GPL-3.0PHPPHP ^7.0 Since Nov 25Pushed 3y ago4 watchersCompare [ Source](https://github.com/TheFox/flickr-cli)[ Packagist](https://packagist.org/packages/thefox/flickr-cli)[ Docs](https://github.com/TheFox/flickr-cli)[ RSS](/packages/thefox-flickr-cli/feed)WikiDiscussions master Synced 2mo ago READMEChangelog (9)Dependencies (12)Versions (15)Used By (0) FlickrCLI ========= [](#flickrcli) A command-line interface to [Flickr](https://www.flickr.com/). Upload and download photos, photo sets, directories via shell. Installation ------------ [](#installation) 1. Clone from Github: ``` git clone https://github.com/TheFox/flickr-cli.git ``` 2. Install dependencies: ``` composer install ``` 3. Go to to create a new API key. The first time you run `./bin/flickr-cli auth` you'll be prompted to enter your new consumer key and secret. Usage ----- [](#usage) First, get the access token: ``` ./bin/flickr-cli auth ``` ### Upload [](#upload) ``` ./bin/flickr-cli upload [-d DESCRIPTION] [-t TAG,...] [-s SET,...] DIRECTORY... ``` ### Download [](#download) ``` ./bin/flickr-cli download -d DIRECTORY [SET...] ``` To download all photosets to directory `photosets`: ``` ./bin/flickr-cli download -d photosets ``` Or to download only the photoset *Holiday 2013*: ``` ./bin/flickr-cli download -d photosets 'Holiday 2013' ``` To download all photos into directories named by photo ID (and so which will not change when you rename albums or photos; perfect for a complete Flickr backup) you can use the `--id-dirs` option: ``` ./bin/flickr-cli download -d flickr_backup --id-dirs ``` This creates a stable directory structure of the form `destination_dir/hash/hash/photo-ID/`and saves the full original photo file along with a `metadata.yml` file containing all photo metadata. The hashes, which are the first two sets of two characters of the MD5 hash of the ID, are required in order to prevent a single directory from containing too many subdirectories (to avoid problems with some filesystems). Usage of the Docker Image ------------------------- [](#usage-of-the-docker-image) ### Setup [](#setup) To use this software within Docker follow this steps. 1. Create a volume. This is used to store the configuration file for the `auth` step. ``` docker volume create flickrcli ``` 2. Get the access token (it will create `config.yml` file in the volume). ``` docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt -v flickrcli:/data thefox21/flickr-cli auth ``` or you can store the `config.yml` in your `$HOME/.flickr-cli` directory and use: ``` mkdir $HOME/.flickr-cli docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt -v "$HOME/.flickr-cli":/data thefox21/flickr-cli auth ``` ### Usage [](#usage-1) Upload directory `2017.06.01-Spindleruv_mlyn` full of JPEGs to Flickr: ``` docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt -v flickrcli:/data thefox21/flickr-cli upload --config=/data/config.yml --tags "2017.06.01 Spindleruv_mlyn" --sets "2017.06.01-Spindleruv_mlyn" 2017.06.01-Spindleruv_mlyn ``` For Docker image troubleshooting you can use: ``` docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt -v flickrcli:/data --entrypoint=/bin/bash thefox21/flickr-cli ``` ### Paths [](#paths) - `/app` - Main Application directory. - `/data` - Volume for variable data. - `/mnt` - Host system's `$PWD`. Documentations -------------- [](#documentations) - [Flickr API documentation](http://www.flickr.com/services/api/) - [Docker documentation](https://docs.docker.com/) License ------- [](#license) Copyright (C) 2016 Christian Mayer 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 . ### Health Score 31 — LowBetter than 68% of packages Maintenance12 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community16 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 85.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~36 days Recently: every ~0 days Total 11 Last Release 3092d ago Major Versions v0.3.0 → v1.0.02016-12-31 v1.1.1 → v2.0.0-rc.12017-11-26 PHP version history (3 changes)v0.1.0PHP ~5.3 || ~7.0 v0.3.0PHP ~5.6 || ~7.0 v1.1.0PHP ^7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/b879f8d5879bc5cb3a1bc43287d0b26834ffc0f403e1b076375da977fe308c55?d=identicon)[TheFox](/maintainers/TheFox) --- Top Contributors [![TheFox](https://avatars.githubusercontent.com/u/353709?v=4)](https://github.com/TheFox "TheFox (86 commits)")[![samwilson](https://avatars.githubusercontent.com/u/213655?v=4)](https://github.com/samwilson "samwilson (12 commits)")[![ruzickap](https://avatars.githubusercontent.com/u/1434387?v=4)](https://github.com/ruzickap "ruzickap (3 commits)") --- Tags command-lineflickrmit-licensephpcliuploadphotodownloadflickr ### Code Quality Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/thefox-flickr-cli/health.svg) ``` [![Health](https://phpackages.com/badges/thefox-flickr-cli/health.svg)](https://phpackages.com/packages/thefox-flickr-cli) ``` ### Alternatives [shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[drush/drush Drush is a command line shell and scripting interface for Drupal, a veritable Swiss Army knife designed to make life easier for those of us who spend some of our working hours hacking away at the command prompt. 2.4k57.4M685](/packages/drush-drush)[silverstripe/framework The SilverStripe framework 7213.5M2.5k](/packages/silverstripe-framework)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)