Skip to content

Download images

The download tool is designed to fetch captures images/photos from encounter search. It renames the filenames to reduce the UUID length. The downloader is a multi-threaded download processer that fetches the images from the search list and downloads them to the export folder.

The filename structure is


for example:



happywhale download -h
usage: happywhale download [-h] --export EXPORT --species SPECIES [--geom GEOM] [--start START] [--end END]

  -h, --help         show this help message and exit

Required named arguments.:
  --export EXPORT    Full path to export folder to download images
  --species SPECIES  Species name or keyword for example Humpback Whale or humpback_whale

Optional named arguments:
  --geom GEOM        Input geometry file in geojson format defaults to Global
  --start START      Start date in format YYYY-MM-DD
  --end END          End date in format YYYY-MM-DD

Last update: 2023-11-08
Created: 2023-11-08