Skip to content

Flickr interaction tools

Notifications You must be signed in to change notification settings


Repository files navigation

Flickr API tools CI


On macOS / *nix:

python3 -m venv venv
source ./venv/bin/activate
make install

M1 Mac Issues

Some libraries (pyexiv2) are not available for M1 yet. Therefore the script needs to be coerced to run under Rosetta. This can be achieved by using iTerm2 as the shell, running it via Rosetta (checkbox on info panel) and, for some reason, using pipenv shell instead of the above venv stanza.



Fetch images from a list of albums into a local directory

For usage, python3 --help

usage: [-h] [--no-download] [--prefer-size-suffix SUFFIX] [--apply-watermark WATERMARK_FILE] [--watermark-opacity WATERMARK_OPACITY] [--limit LIMIT] [--delete-missing]
                 [--sort-order {natural,random,alphabetical,taken}] [--sort-reverse] [--save-photo-list SAVE_PHOTO_LIST]
                 album_id [output]

Download Flickr album images to a directory for use in screensavers, etc

positional arguments:
  album_id              Numeric ID of album from Flickr URL. Can be a comma-separated list.
  output                Directory to save files to

optional arguments:
  -h, --help            show this help message and exit
  --no-download         Don't download any files
  --prefer-size-suffix SUFFIX
                        Preferred download size; see
  --apply-watermark WATERMARK_FILE
                        Add watermark to bottom right
  --watermark-opacity WATERMARK_OPACITY
                        Set watermark opacity, 0-1
  --limit LIMIT         Max images to download
  --delete-missing      Delete images not found in album
  --sort-order {natural,random,alphabetical,taken}
                        One of
  --sort-reverse        Reverse sort order
  --save-photo-list SAVE_PHOTO_LIST
                        File to export JSON album index to

eg python3 72157714807457311 download

To set up an OSX screensaver using a downloaded album, see docs/

Valid size suffixes: See

The watermark function is intended only for download and processing of your own images.

Watermark all of the JPG images in a specified folder, adding new versions in a subdirectory. You will need to supply a transparent png/gif as the watermark. The watermark is assumed to be white-on-transparent and will be inverted when being applied to a lighter area.

For usage, python3 --help

usage: [-h] [--limit LIMIT] [--resize MAX_EDGE] dir

Watermark images in a directory, saved to a /watermarks subdirectory

positional arguments:
  dir                Directory containing files to watermark

optional arguments:
  -h, --help         show this help message and exit
  --limit LIMIT      Max images to process
  --resize MAX_EDGE  Resize to fit box

Post tweets containing an image on a daily schedule. The script can take input in two forms; either a directory full of files or a text file listing images to post. The format of filenames or lines of the file should be:




Each time the script runs, it will check today's date, look for a flickr ID in a filename containing that date, and use the Flickr and Twitter APIs to find, describe and tweet that image.

This script can be also used as an AWS lambda script, to run from a Cloudwatch schedule. The batch file "" helps build the appropriate lambda bundle.

For usage, python3 --help

usage: [-h] (--source-flickr-download-dir SOURCE_FLICKR_DOWNLOAD_DIR | --source-flickr-file-list SOURCE_FLICKR_FILE_LIST) [--dry-run]

Create tweet with image from encoded input

optional arguments:
  -h, --help            show this help message and exit
  --source-flickr-download-dir SOURCE_FLICKR_DOWNLOAD_DIR
                        Directory of coded flickr downloads to use as source
  --source-flickr-file-list SOURCE_FLICKR_FILE_LIST
                        File containing list of Flickr photo dates/ids  
  --dry-run             Prepare the tweet but don't send it

Modifies image keywords, subject and filename to help find and identify files, for all files in a directory:

  • If no subject, longest keyword is assumed to be subject
  • Any image ID found in the filename is stored as a keyword 'library:fileId=NUMBER'
  • Optionally, filename is modified to include the subject

Usage: python3 -h

usage: [-h] [--rename] dir

Improve keywords and title organization for all images in a folder for upload to flickr, etc

positional arguments:
  dir         Directory containing files to watermark

optional arguments:
  -h, --help  show this help message and exit
  --rename    Modify filename to include subject

A utility script to help generate a list of files suitable for

This script is very specific to my workflow, so feel free to work with it but I won't document it here. --help works as you'd expect.

Another utility script, this one lets you download files listed in a JSON file of specific format, which can be hosted online or shared.

Again, fairly specific to my use-case, so use --help for info

JSON format is:

    "url": "https://domain.tld/path/to/file.jpg",
    "local_file": "intended_local_filename.jpg",
    "title": "Plain Text",
    "taken": "2020-07-04 12:04:54"

Code Maturity

This code is WOMM-compliant; it is not intended to be generally robust. Feel free to send requests or PRs, or fork this.


Built on