samwilson/phpflickr-cli

A command line interface for Flickr.

0.5.0 2024-06-13 02:28 UTC

README

This is a command-line interface (CLI) to Flickr, written in PHP, using the samwilson/phpflickr library.

Build status

Features:

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

Installation

Get the code and install dependencies:

git clone https://github.com/samwilson/phpflickr-cli
cd phpflickr-cli
composer install --no-dev

Run the app:

./phpflickr-cli --help

Upgrading

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

Authorization

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

Downloading

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.

Checksums

Add MD5 or SHA1 checksum machine tags to images:

./phpflickr-cli checksums --help

Requires authorization.

Kudos

License

GPL-3.0-or-later

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 https://www.gnu.org/licenses/