GUIDEWhy Swarm export photos have no date or place

Your Swarm check-in photos, back on their day, with the place.

Foursquare’s Swarm export hands you every photo in a pix/ folder with a file name that says nothing: no date, no place. Both are in the same export, in photos.json and checkins.json. CheckinRedate matches each photo to its check-in by ID and writes the date, the time zone and the venue name into the file itself (EXIF), right in your browser.

  • Nothing uploaded, no Foursquare login
  • No Python, no ExifTool, no command line
  • Your original export is not changed

At a glance

What CheckinRedate does and doesn’t do

  • Works withThe ZIP from Foursquare Swarm’s “Export my data”: checkins1.json…, photos.json and the pix/ folder. The ZIP as downloaded, or the extracted folder.
  • RestoresThe date and time of the check-in each photo belongs to, in the check-in’s own time zone, and the venue name. Written into each JPEG (EXIF DateTimeOriginal, OffsetTimeOriginal, ImageDescription), into the file name, and set as the file date in the new ZIP.
  • Runs onAny browser on Windows, Mac, Linux or Chromebook. On a phone it works with small exports. Nothing to install.
  • Free25 photos per run, with the full report. Full: $9 one-time, every photo.
  • PrivacyNothing is uploaded. No Foursquare login. Your check-ins and photos stay on your device.
  • Doesn’tWrite GPS coordinates: the check-ins in the Swarm export carry no coordinates, only the venue’s name and ID, so photos get the right day and the place name but do not show on a map. It gives you a ZIP; it does not change your photo library.
Writes the EXIF date read by
  • Google Photos
  • Apple Photos
  • Windows Photos
  • Lightroom
  • Immich
  • Synology Photos
by ID

each photo is matched to its check-in by the ID in photos.json, not by a guess from dates

How the match works
0 bytes

of your check-ins and photos sent to any server

How it works
25

photos redated free per run, with the full report of your export

Try it
$9

once, every photo, no subscription

Pricing

The problem

Years of check-in photos, with no date and no place.

The export is free and it is your data. But the photos arrive cut off from the check-ins they belong to.

Nothing in the file says when

The photos sit in pix/ with names like 15234_86lNtfs9z3m9….jpg. Apple Photos and Google Photos file them under the day you extracted the ZIP.

The date is in two JSON files

photos.json links each photo to a check-in ID. checkins1.json, checkins2.json… hold the time, the time zone and the venue of each check-in. No photo app reads them.

Joining them is a script

The usual advice is ExifTool plus a Python script you write yourself to join the two files. That works, if you want to write and debug it.

How it works

Three steps. No Python, no ExifTool, no command line.

  1. Step 1

    Request your Swarm export

    In your Foursquare privacy settings, choose Export my data. Foursquare emails you a link to a ZIP when it is ready. Step-by-step guide

  2. Step 2

    Add the ZIP here

    As downloaded, or the extracted folder. CheckinRedate reads photos.json and every checkinsN.json, and matches each photo in pix/ to its check-in by ID.

  3. Step 3

    Download the redated ZIP

    One new ZIP: a folder per year, files named with date, time and venue, each JPEG with its date and venue written in, plus a manifest.csv that lists what could not be matched.

Redate

Open your Swarm export

Everything runs on this page. Your check-ins and photos never leave your device.

Drop your Swarm export .zip or the extracted folder here

It must include photos.json, the checkins JSON files and the pix/ folder. Nothing is uploaded.

The date written is the time of the check-in, in the check-in’s own time zone. No GPS is written: the Swarm export has no coordinates.

Free: 25 photos per run and the full report. Unlock every photo for $9.

Standard metadata

Written where photo apps already look.

No sidecar files, no special tags. CheckinRedate writes the same EXIF fields a camera or phone writes, so galleries, backup tools and file managers can read them.

  • JPEG: EXIF DateTimeOriginal + DateTimeThe field apps show as Date Taken, in the local time of the check-in. A photo that already has one is left exactly as it is.
  • Time zone: EXIF OffsetTimeOriginalThe check-in’s own offset from UTC (for example -05:00), taken from timeZoneOffset in the export.
  • Venue: EXIF ImageDescription + file nameThe name of the place you checked in. No GPS tags: the export has no coordinates to write.
Terminal · check a redated photo
$ exiftool -DateTimeOriginal -OffsetTimeOriginal -ImageDescription "2019-06-02_184015_Lakeside Diner.jpg"
  Date/Time Original   : 2019:06:02 18:40:15
  Offset Time Original : -05:00
  Image Description    : Lakeside Diner
manifest.csv
New file, Date, Time zone, Venue, Date source, Written
2019/2019-06-02_184015_Lakeside Diner.jpg, 2019-06-02 18:40:15, -05:00, Lakeside Diner, check-in, EXIF date + venue
2021/2021-08-14_131244_Union Station.jpg, 2021-08-14 13:12:44, UTC, Union Station, photo, EXIF date + venue
unmatched/IMG_0042.jpg, , , , , not in photos.json: copied unchanged

What you get back

Every check-in photo on its day, named after the place.

The export lists each photo with the ID of its check-in, and each check-in with its time, time zone and venue. CheckinRedate joins them photo by photo.

Matched by ID

Each file in pix/ is matched to its photos.json entry by file name, then to its check-in by the check-in ID. Never by the download date.

Date inside the file

Writes DateTimeOriginal into each JPEG, in the check-in’s local time and with its UTC offset, not just a file date that changes when the file is copied.

Named after the place

Files like 2019/2019-06-02_184015_Lakeside Diner.jpg instead of pix/15234_86lN….jpg, with the venue name in the EXIF description too.

The whole export in one batch

Thousands of photos and every checkinsN.json together. Reads the ZIP without unzipping it first.

Private by design

There is no upload step and no Foursquare login. Your check-ins are read and the photos rewritten in this browser tab only.

A report of what did not match

manifest.csv lists every photo: date, time zone, venue, check-in ID and link, what was written, and what could not be done.

Compared

Three ways to deal with the photos of a Swarm export.

The free routes are good tools and keep your files on your computer too. CheckinRedate is for getting the date and venue into the photos without writing a script.

FeatureCheckinRedateExifTool + your own Python scriptSwarm-Checkins-Import (GitHub)
What it is forPutting date and venue into the export’s photosWriting any metadata into any file; the usual advice for this jobImporting your check-ins into your own website through Micropub
CostFree for 25 photos, $9 once for allFreeFree
Joins photos.json with the check-insYes, automatically, by IDYou write and debug the join yourselfReads the check-ins to post them; it does not fix the photo files
Writes the date into the photosYes: EXIF DateTimeOriginal with the check-in’s time zoneYes, any field you scriptNo
Venue name in the photo and file nameYesIf you script itNo (the venue goes into the post on your site)
GPS coordinatesNo: the export has noneYes, if you get coordinates from another source—
What you installNothingExifTool and PythonPHP and a Micropub website
How you run itDrop the ZIP on a web pageCommand lineCommand line
Your original filesOnly read; you get a new ZIPDepends on the options you passNot changed
Files leave your deviceNeverNeverCheck-ins are posted to your own site

Pricing

Free for 25 photos. $9 once for all of them.

Start free

Free

$0

Redate 25 photos per run and see the full report of everything in your export.

Redate my Swarm photos
  • Full report: every photo and check-in found
  • 25 photos with date and venue written
  • Year folders and manifest.csv
  • No account

ONE-TIME

CheckinRedate Full

$9 USD

one-time · every photo · any number of exports

Unlock every photo, $9
  • Every photo in your Swarm export
  • Thousands of photos in one run
  • Run it again on future exports
  • No subscription
Secure checkout by Stripe. The full version unlocks in the browser you pay from. Questions: support@cedanolabs.org.

FAQ

Questions about Swarm export photo dates

Want the long version? Read the guide.

Read the guide
Why do the photos in my Foursquare Swarm export have no date or place?

In the export, the photos are in a folder named pix with file names like 15234_86lNtfs9z3m9….jpg. In the real export we tested, nothing in the file name says when or where a photo was taken, so photo apps file them under the day the ZIP was extracted. The date and the place are in the same export, in two other files: photos.json lists every photo with a link to its check-in, and checkins1.json, checkins2.json… list every check-in with its time, time zone and venue name. CheckinRedate joins them and writes the result into each photo.

How does it know which check-in a photo belongs to?

By ID, not by guessing from dates. Each entry in photos.json has a suffix field that is the file name in pix/, and a relatedItemUrl that ends in the ID of the check-in (https://www.swarmapp.com/checkin/…). CheckinRedate matches the file name to its entry, then looks that check-in ID up in your checkins JSON files. In the real export we tested, 737 of 778 photos pointed to a check-in this way.

Which date and time zone does it write?

The time of the check-in, in the local time of the place where you checked in. Swarm stores each check-in time in UTC together with a timeZoneOffset in minutes; CheckinRedate applies that offset and writes the result as EXIF DateTimeOriginal and DateTime, plus the offset itself as EXIF OffsetTimeOriginal. A check-in at 6:40 PM in Chicago is written as 6:40 PM, wherever you run the tool.

Does it add GPS coordinates so the photos show on the map?

No. The check-ins in the Swarm export carry no coordinates: each venue has only an ID, a name and a link. CheckinRedate does not invent a location, so it writes no GPS. Your photos land on the right day and carry the venue name in their description and file name, but they will not appear on the map of Apple Photos or Google Photos.

Will the photos show up on the right day in Apple Photos, Google Photos and Lightroom?

CheckinRedate writes EXIF DateTimeOriginal, the field those apps read to place a photo on the timeline. Extract the new ZIP and import the year folders. The venue name is written to EXIF ImageDescription, which apps that read that field show as the caption or description; it is also in every file name, so you can search for it anywhere.

Where does the venue name go?

In three places: the EXIF ImageDescription of the photo, the file name (2019-06-02_184015_Venue Name.jpg) and the venue column of manifest.csv, next to the check-in ID and link.

What about photos that are not linked to a check-in?

Some photos in photos.json point to a venue page or a tip instead of a check-in. Those get the date of the photo itself (createdAt in photos.json, which is UTC and has no time zone offset), and the venue name when the link is a venue that appears in your check-ins. A file in pix/ that photos.json does not list at all is copied untouched into a folder named unmatched. A photo that already has an EXIF DateTimeOriginal is left byte for byte as it is and only renamed. manifest.csv says which case each photo was.

How do I get my Swarm export?

Foursquare offers it under the privacy settings of your account as "Export my data" (also described as a data download request). You ask for it once, and Foursquare emails you a link to a ZIP when it is ready. The ZIP holds checkins1.json, checkins2.json and so on (1,000 check-ins each), photos.json and the pix folder, along with other files CheckinRedate does not need.

Are my check-ins or photos uploaded anywhere?

No. The files are read and the new ZIP is built by JavaScript on this page, on your device. There is no upload step and no Foursquare login. The only network requests are for the page itself, cookieless page analytics, and the payment check if you buy the full version, which sends a payment ID and never a file.

Do I need Python, ExifTool or the command line?

No. Nothing is installed. It runs in any current browser on Windows, Mac, Linux or a Chromebook, and does the whole export in one batch. It also runs in a phone browser, which is fine for a small export; for a big one use a computer.

How many photos can it handle at once?

Thousands: the whole pix folder in one run. The limit is the new ZIP, which is built in your browser's memory and can hold up to 4 GB and 65,535 files. A big export is best done on a computer with free memory.

How are the photos organized in the new ZIP?

One ZIP named swarm-photos-redated.zip with a folder per year (2019/, 2020/…), a folder named unmatched for files photos.json does not list, and manifest.csv. Each file name starts with the date and time of the check-in and ends with the venue name, so the photos sort in order in any file manager. Each file in the ZIP also carries the date as its file date.

Does it change my original export?

No. The export is only read. You get a new ZIP and decide what to do with it. Apart from the EXIF block that is added, the image data of each JPEG is copied as it is: nothing is re-compressed.

How does the $9 full version work?

Free processes 25 photos per run and shows the full report of everything it found. The full version is a single $9 payment, with no subscription and no account, and processes every photo, in any number of exports. It unlocks in the browser you pay from.

Put your check-in photos back on their days.

Add the ZIP of your Swarm export and get every photo back with its check-in date and venue name. The first 25 photos are free.