GUIDEWhat the JSON files in a Flickr data download mean

Your Flickr download, with titles, albums and dates back.

Flickr’s data download hands you photos named by number, and puts the titles, descriptions, tags and albums in thousands of separate JSON files. AlbumTidy pairs each photo with its JSON by Flickr ID, writes the title, description, tags and missing date into the file and rebuilds your albums as folders, right in your browser.

  • Nothing uploaded, ever
  • No install, no account
  • No Python or ExifTool
  • Works withThe ZIPs from Flickr’s “Request My Flickr Data”: the account data ZIP (the JSON files) plus the data-download photo ZIPs, dropped together, as downloaded.
  • RestoresTitles, descriptions and tags into each JPEG. The date taken when a photo has none. Albums as folders. File names like 2017-08-02_Sugarlands overlook.jpg.
  • Runs onAny browser: Windows, Mac, iPhone, Android. Nothing to install.
  • Free25 photos, with the full report. Full: $9 one-time.
  • PrivacyFiles never leave your browser.
  • Doesn’tChange videos, PNG, GIF or HEIC files (they are renamed and sorted, byte for byte). Read unzipped folders. Hold a very large export in memory in one go: big exports are done in batches. Upload anything to Flickr or to another photo service.
Written as standard fields
  • EXIF DateTimeOriginal
  • EXIF ImageDescription
  • EXIF GPS
  • XMP dc:title
  • XMP dc:description
  • XMP dc:subject
1 per photo

a photo_<id>.json file holds the title, tags and albums Flickr kept apart

What is in the JSON
0 bytes

of your photos sent to any server

How it works
25 photos

free, with the full report for your whole export

Try it
$9

once, every photo, no subscription

Pricing

The problem

You asked for your photos. You got numbers and JSON.

Flickr says it plainly: “Any details added to your photos after upload will be compiled in a separate JSON file” (Flickr Help). So the download is complete, but it is not a photo library.

File names are numbers

Every photo carries its Flickr ID in the name, like img_0642_3051711960_o.jpg. Untitled ones are only an ID and a code.

Titles and albums sit in JSON

One photo_<id>.json per photo plus an albums.json. No photo app reads them, and no folder tells you the album.

Split across ZIPs

The JSON files come in the account data ZIP and the photos in a series of data-download ZIPs, so a photo and its JSON never sit side by side.

How it works

Three steps. No unzipping by hand.

  1. Step 1

    Request your Flickr data

    On Flickr: your profile photo → Settings → under Your Flickr Data, select Request My Flickr Data. Flickr emails you when the ZIPs are ready, which takes from a few hours to a few weeks. What is in the download

  2. Step 2

    Drop every ZIP here

    The account data ZIP and all the photo ZIPs, together. AlbumTidy pairs each photo with its photo_<id>.json through the Flickr ID in the file name and handles exports that come in many parts.

  3. Step 3

    Download the tidy ZIP

    Album folders, files named by date and title, the details written into each JPEG, plus manifest.csv and unmatched.csv. Your original download is never modified.

Tidy

Open your Flickr data download

Everything runs on this page. Your photos never leave your device.

Drop all your Flickr ZIPs here

The account data ZIP (the JSON files) and every data-download ZIP, together, as Flickr sent them. No unzipping.

Best on a computer (Chrome, Edge, Firefox or Safari). Big export? Do it in batches: the account data ZIP plus a few photo ZIPs at a time.

Standard metadata

Written where photo apps look.

No sidecar files, no proprietary tags. AlbumTidy writes standard EXIF and XMP fields into each JPEG, and never replaces a value the photo already has.

  • EXIF DateTimeOriginalThe date taken from the JSON, only when the photo has no capture date. A date your camera wrote is kept.
  • XMP dc:title · dc:description · dc:subjectTitle, description and tags. The description also goes to EXIF ImageDescription when that field is empty.
  • EXIF GPSLatitude and longitude from the JSON, only when the photo has no GPS of its own.
Terminal · check a tidied photo (optional)
$ exiftool -G1 -DateTimeOriginal -ImageDescription -XMP-dc:all -GPSLatitude -GPSLongitude photo.jpg
[ExifIFD]   Date/Time Original : 2017:08:02 19:44:10
[IFD0]      Image Description  : Morning fog over the Smokies
[XMP-dc]    Title              : Sugarlands overlook
[XMP-dc]    Description        : Morning fog over the Smokies
[XMP-dc]    Subject            : smokymountains, tennessee
[Composite] GPS Latitude       : 35 deg 41' 8.84" N
[Composite] GPS Longitude      : 83 deg 32' 12.37" W
manifest.csv · one row per photo
Flickr ID,Original file,New file,…,Date uploaded,…,Albums
3051711960,img_0642_3051711960_o.jpg,
  Smoky Mountains Trip/2017-08-02_Sugarlands overlook.jpg,
  …,2017-08-05 08:00:01,…,Smoky Mountains Trip; Best of 2017

What you get back

Every photo, back with its name and its album.

The photos in a Flickr download keep the EXIF they had when you uploaded them. Everything you added on Flickr afterwards is in the JSON. AlbumTidy puts the two together, file by file.

Matched by Flickr ID

Each photo is paired with its photo_<id>.json by the Flickr ID in its file name. Titled, untitled and video file names are all recognized.

Titles and descriptions back in the file

Written into each JPEG as XMP title and description, plus the EXIF description. The title also becomes the file name.

Albums as folders

One folder per album. A photo in several albums is saved once, in its first album, and the other albums are listed in the manifest. Photos in no album go to No album/ by year.

Date taken, and date uploaded apart

The date taken is written into photos that have none and starts every file name. The upload date is kept separately, in manifest.csv.

Tags and GPS

In JPEGs, tags are written as XMP keywords and GPS as EXIF coordinates when the photo has none. Both are also in manifest.csv. For videos and other formats they are in manifest.csv only.

Shows its work

unmatched.csv reports photos with no JSON and JSON files with no photo. manifest.csv maps every original name to the new one, with the Flickr URL.

Compared

Three ways to deal with a Flickr download.

FeatureAlbumTidyThe raw downloadPython scripts + ExifTool
Cost25 photos free, $9 once for allFreeFree
Titles and descriptions in the photoYesNo, in separate JSON filesYes, depending on the script
Albums as foldersYesNoSome scripts
What you installNothingNothingPython, ExifTool, a terminal
Report of unmatched filesYes, unmatched.csv—Depends on the script
Files leave your deviceNever—Never

Pricing

Try 25 photos free. Keep everything for $9.

Start free

Free

$0

The full report for your whole export, and 25 photos written.

Tidy my Flickr download
  • Full report: photos, albums, unmatched files
  • 25 photos with title, description, tags and date
  • manifest.csv and unmatched.csv
  • No account

ONE-TIME

AlbumTidy Full

$9 USD

one-time · no subscription · any number of exports

Unlock every photo, $9
  • Every photo and video in your export
  • All your albums as folders
  • Multi-part exports, result in ZIPs of up to 1 GB
  • Run it again on your next download
Secure checkout by Stripe. The full version unlocks in the browser you pay from. Questions: support@cedanolabs.org

FAQ

Questions about Flickr downloads

Want to know what each file in the download is? Read the guide.

Read the guide
Are my photos uploaded anywhere?

No. The ZIPs are read and the new files are built by JavaScript on this page, on your device. The only network requests are for the page itself, anonymous page analytics and, if you buy the full version, Stripe checkout and a payment check that sends a Stripe session ID, never a file.

Why are the titles and albums missing from my downloaded Flickr photos?

Because Flickr keeps them apart. The downloaded files only carry the EXIF data they had when you uploaded them and, in Flickr's words, "Any details added to your photos after upload will be compiled in a separate JSON file" (Flickr Help). The title, description, tags and albums you added on Flickr are in those JSON files, not in the photos.

How does AlbumTidy match a photo to its JSON file?

By the Flickr photo ID. Flickr puts the ID in the photo's file name, for example img_0642_3051711960_o.jpg, and names the JSON photo_3051711960.json. Untitled photos (30410016513_b941ab820b_o.jpg) and videos (clip_54052605627.mov) are matched the same way. A number in a file name only counts as the ID when a JSON file with that ID exists.

What exactly is written into each photo?

Into JPEG files: the title, description and tags as XMP (dc:title, dc:description, dc:subject), the description as EXIF ImageDescription (the title if there is no description), the date taken as EXIF DateTimeOriginal and the location as EXIF GPS. A field is only written when the photo does not have it yet, so the date and GPS your camera wrote are kept. Videos, PNG, GIF and HEIC files are renamed and sorted but their bytes are not changed; their details are in manifest.csv.

What happens to a photo that is in several albums?

It is saved once, in the folder of its first album, so the result is not bigger than your export. The other albums are listed in the Albums column of manifest.csv. Photos that are in no album go to No album/, in one folder per year.

Which date is used?

The "date taken" that Flickr stores in each JSON file. It is written into the photo only when the photo has no capture date of its own, and it starts every file name (2017-08-02_Sugarlands overlook.jpg). Flickr gives this date without a time zone, and it is written as it is. The date you uploaded the photo is kept apart, in the "Date uploaded" column of manifest.csv.

Does it change my original download or my Flickr account?

No. AlbumTidy never modifies the ZIPs you got from Flickr: it reads them and builds a new ZIP. It does not connect to Flickr, and you do not sign in to anything.

How big an export can it handle?

The Flickr ZIPs are read in place, without unzipping, including multi-part exports and ZIP64 archives. The result is built in your browser's memory and saved as one or more ZIPs of up to 1 GB each, so how much fits in one run depends on the memory of your computer. For a large export, work in batches: drop the account data ZIP together with a few photo ZIPs, save the result, and repeat with the next photo ZIPs. Folder and file names are decided from the JSON files, so they come out the same in every batch and the results unzip into one tidy library.

Do I need Python, ExifTool or the command line?

No. There is no Python, no ExifTool and nothing to install. The whole job runs in the browser tab.

Does it work on a phone?

It runs in any current browser, on iPhone and Android too, and that is fine for a small export. A big export needs the memory and disk of a laptop or desktop.

How does the $9 full version work?

Free shows the full report for your whole export and writes 25 photos. The full version is a single $9 payment, with no subscription, and writes every photo. It unlocks in the browser you pay from and works for any number of exports.

Put the names back on your Flickr photos.

Drop the ZIPs, read the full report and get 25 photos back for free.