Download entire iCloud shared albums

icloud-album-download.sh

#!/bin/bash

# requires jq
# arg 1: iCloud web album URL
# arg 2: folder to download into (optional)

function curl_post_json {
	curl -sH "Content-Type: application/json" -X POST -d "@-" "$@"
}

BASE_API_URL="https://p23-sharedstreams.icloud.com/$(echo $1 | cut -d# -f2)/sharedstreams"

pushd $2 > /dev/null
STREAM=$(echo '{"streamCtag":null}' | curl_post_json "$BASE_API_URL/webstream")
CHECKSUMS=$(echo $STREAM | jq -r '.photos[] | [(.derivatives[] | {size: .fileSize | tonumber, value: .checksum})] | max_by(.size | tonumber).value')

echo $STREAM \
| jq -c "{photoGuids: [.photos[].photoGuid]}" \
| curl_post_json "$BASE_API_URL/webasseturls" \
| jq -r '.items[] | "https://" + .url_location + .url_path' \
| while read URL; do
	for CHECKSUM in $CHECKSUMS; do
		if echo $URL | grep $CHECKSUM > /dev/null; then
			curl -sOJ $URL &
			break
		fi
	done
done

popd > /dev/null
wait

@GodSaveEarth This worked great for me, major props. I have Android and my family sent a big iCloud photo share link so I was able to DL on my windows desktop and then drag and drop them all to Google Photos web.

I've made some modifications to the script to suit my use case

• now uses the file name from the Content-Disposition header rather than the URL when checking filenames.
  • I had issues with it not seeing space symbols in filenames because the url had + characters instead
• checks for files in the download folder that aren't part of the icloud shared album, and deletes them
  • only if they're a media file with a known extension
  • and only if you're running this while specifying an output directory

It's here: icloud_photo.sh

Never coded in java, but I guess the script curl_post_json is doing a json post on the serve using curl. I google-translated it into bash. Unfortunately, the curl post returned null from https://p23-sharedstreams.icloud.com/$(echo $1 | cut -d# -f2)/sharedstreams. Can someone help to point to a working stream server that still provides the webstream API. Thanks a lot. Just want to download a lot of pictures from kid's soccer game.