The -well tools · Datewell · User Guide
Datewell icon

Datewell™ User Guide

Date Taken Fixer

The guide that comes with Datewell 1.7.5, the current version

New to Datewell? Watch the 79-second introduction.

Contents
  1. What Datewell is
  2. Quick start
  3. Date photos from their file names
  4. Date photos from a Google, Apple or Facebook download
  5. Date prints from a camera's date stamp
  6. Date prints from the date on their border
  7. Date prints in an order you choose
  8. Settings
  9. What Datewell writes
  10. The app in detail
  11. The Lightroom Classic plug-in in detail
  12. Undo
  13. Keyboard and Stream Deck
  14. Install
  15. License and free trial
  16. Updates
  17. Help
  18. Appendix: What's new
  19. Appendix: License and credits

What Datewell is

Datewell sets each photo's Date taken from the date written in its file name. Scans named 1987-07-04 Lake Tahoe.jpg, phone pictures named IMG_20190312_142310.jpg, or prints named July 1965 Christmas.tif all get the right date, so they sort into the right place in Lightroom Classic, Windows, Apple Photos, Google Photos and every other program that reads photo dates.

Datewell comes two ways, with one license for both:

  • The Datewell app, for Windows and Mac. It opens in your web browser and doesn't need Lightroom.
  • The Lightroom Classic plug-in: Library > Plug-in Extras > Set Date Taken..., and Date photos in their Lightroom order for photos you sorted by hand.

Nothing is changed until you have seen a preview and clicked Write dates, and every run can be undone.

Quick start

  1. Install: run the Setup program on Windows, or Install Datewell on a Mac, and choose the app, the Lightroom Classic plug-in or both (see Install).

In the app

  1. Open Datewell from the Start menu, or from Applications > ThePictureOrg on a Mac. It opens in your web browser.
  2. Click Choose a folder and pick a folder of photos.
  3. Click Preview the dates. Each photo shows the date found in its name and the date it has now.
  4. Untick any photo you want left alone, then click Write dates.

Changed your mind? Click Undo this run.

In Lightroom Classic

  1. Select the photos in the Library and choose Library > Plug-in Extras > Set Date Taken..., and click Preview.
  2. Check the dates, then click Write dates. Datewell first has Lightroom save its own changes (crops, keywords) to the files, writes the dates, and has Lightroom read the new dates from the files.

To put the old dates back: Library > Plug-in Extras > Undo a Datewell run.

Next: Date photos from their file names, Date prints from a camera's date stamp, Date prints from the date on their border, Date prints in an order you choose.

Date photos from their file names

File name Date taken
IMG_20190312_142310.jpg, PXL_20230101_142310123.jpg March 12, 2019, 2:23:10 PM
2004-07-04 14.23.10.jpg, 20040704_142310.jpg July 4, 2004, 2:23:10 PM
2004-07-04 picnic.jpg, 2004_07_04.tif, 20040704.jpg July 4, 2004
Screenshot_2021-03-12-14-23-10.png March 12, 2021, 2:23:10 PM
IMG-20190312-WA0001.jpg (WhatsApp) March 12, 2019
07-04-2004.jpg July 4, 2004 (US order) or 7 April 2004 (day first: your choice)
25.12.1987.jpg December 25, 1987 (25 can't be a month, so no choice is needed)
07-04-87.jpg July 4, 1987 (two-digit years: your choice of order)
July 4 1987.jpg, 4 Jul 1987.jpg, 1987-Jul-04.jpg July 4, 1987
July 1987 Lake Tahoe.jpg, 1987-07 Lake Tahoe.jpg, 1985-01-001.dng July 1987; January 1985 (a last number such as -001 is the photo's own number)
4. Juli 1987.jpg, 4 juillet 1987.jpg, 4 de julio de 1987.jpg, Dezember 1965.jpg July 4, 1987; December 1965 (month names in German, French, Spanish, Italian, Dutch, Portuguese, Swedish, Danish and Norwegian, with or without accents)
1971 Summer.jpg, Fall of 1965.jpg the middle month of the season: July 1971, October 1965 (winter: January, spring: April, autumn: October)
1965 Christmas.jpg, Thanksgiving 1984.jpg, Easter 1990.jpg that year's holiday: December 25, 1965; November 22, 1984; April 15, 1990
Smith_1965_042.jpg 1965 (dated January 1)
FB_IMG_1487539846123.jpg (saved from Facebook) the moment it was saved

Datewell never guesses. It leaves a photo alone, and says why, when:

  • the name has no date (IMG_0042.jpg), or a picture number that only looks like a year (IMG_1987.jpg, DSC_2004.JPG);
  • the name has two different dates (2004-07-04 copy of 2003-01-01.jpg) or a range (1987-1989 album.jpg);
  • the date doesn't exist (2004-02-30) or is in the future.

Dates without a time get 12:00 noon, so a time zone change can't move them to the day before. You can choose another time under More.

Numbered photos with the same date (on by default): when the name has no time and other photos in the same folder have the same date, each one's time follows its number, starting from noon: 2004-12-01_December-0001.jpg gets 12:01:00 PM, -0002 gets 12:02:00 PM, -0010 gets 12:10:00 PM. Sorting by file name or by Date taken then gives the same order. A copy such as -0003 (2) gets a second after -0003, and a raw file and its JPEG with the same name get the same time. When photos from several folders share a date in one run, each folder gets its own hour, in folder-name order: the first folder's photos 12:01, 12:02 and so on, the next folder's 13:01, 13:02, so the folders don't mix when sorted by time (a second each when a folder has 60 or more). A time already in the name (IMG_20190312_142310.jpg) is always kept. Turn it off under Times ("Photos with the same date follow their numbers") to give them all noon.

Year-only and month-only names get January 1 or the first of the month as their Date taken, because the EXIF Date taken needs a full date. The XMP "Date Created" field keeps exactly what the name said (1987 or 1987-07), so programs that understand partial dates show them as such.

Try a name: type any file name in the app's "Try a name" box to see what Datewell reads from it, without touching any photos.

Date photos from a Google, Apple or Facebook download

Photos downloaded from Google Photos, iCloud or Facebook often carry the day they were downloaded, not the day they were taken. The real date is usually in a separate file the download puts beside the photos. Datewell reads these files on its own: there is nothing to choose. Keep the download's folders as they came (unzip them, but don't move the photos away from the files beside them).

  • Google Takeout: a .json file beside each photo, such as IMG_1234.JPG.json or IMG_1234.JPG.supplemental-metadata.json. Datewell finds the right one even when Google cut the name short, numbered a copy (IMG_1234(1).JPG goes with IMG_1234.JPG(1).json), or made an edited copy (IMG_1234-edited.JPG uses the original's file). The video half of a Live Photo gets its photo's date.
  • Apple Photos on a Mac: choose File > Export > Export Unmodified Original and tick Export IPTC as XMP. Each photo gets an .xmp file with its date.
  • iCloud (a copy of your data from privacy.apple.com): the Photo Details.csv file in each folder of photos.
  • Facebook ("Download your information", in either format, HTML or JSON): the album and post pages list each photo. When Facebook kept the camera's date, that's used. Otherwise Facebook only knows when the photo was put on Facebook, so that date is used only when nothing else (name, stamp or border) gives one, and the preview says "only the date it was uploaded".

The download's date comes before the date in the name and the date in the picture. A photo that already has a camera's own Date taken keeps it, and the preview shows what the download said. Tick Their date replaces a camera's own Date taken to use the download's date instead. Google keeps its dates in world time (UTC), so Datewell turns them into your computer's time and writes the time zone with them.

The preview counts the photos that had a download file, those with no file found, and those whose file has no date.

Date prints from a camera's date stamp

Many film cameras from the 1980s to the 2000s could print the date into the picture: orange or red digits in the bottom right corner, such as 91 1 27, 30 10 '97 or 7 3 '00. When a photo's name has no date, or only a year (or, with Which date comes first, when the name's date is this year or a photo scanner's), Datewell looks for such a stamp in the picture's corner (either way up, and for photos scanned on their side) and reads it digit by digit. The preview shows these photos as "camera date stamp", with the digits it read. A stamp sets the full date. When the name has a year, the stamp must be from that same year, so a camera whose clock was set wrong can't move a photo to another year; if one digit of the year is hard to read, the name's year is used when the other digit matches.

The year is the field after the apostrophe ('97), or the first one when there is none (97 12 20). When the other two could be month-day or day-month, the "Dates like 07-04-2004" setting decides. This works for JPEG, TIFF, PNG, DNG and camera raw files (NEF, CR2, ARW and others) and takes a few seconds a photo. Photos turned in Lightroom are read the way Lightroom shows them. A stamp crossed by something bright red, or printed on a bright orange background, may not be read; the photo then keeps the name's year. Turn it off with "read a camera's orange date stamp" in the settings.

Thin, faint stamps from quartz date backs are read too: Datewell zooms in on the corner and looks for the digits' orange light, even over a busy background.

Stamps made of dots are read too, such as the 1 20 '05 some 2000s cameras printed, five dots across and seven down.

When part of a stamp is hidden (a bright shirt or a white box behind the digits), Datewell compares what it can see, such as 6 '97, with the stamps of the photos next to it in the same folder. If exactly one of their dates fits, the photo gets that date and the note says so. These photos are flagged too, so you can check them; in the preview their date is shown in orange.

When Datewell sees a stamp but can't read all of it, it flags the photo so you can check it by hand. The note says what it could read, and the close-up shows the stamp so you can read it yourself. In the app, the "Date stamp not read" filter lists those photos. In Lightroom Classic, they get the keyword Picture Org > Check date stamp: click it in the Keyword List to see them all. Like all keywords our plug-ins add, it is never exported with your photos. When Datewell can't have Lightroom read the new dates for you, read them first (Metadata > Read Metadata from Files) and then run Datewell again on those photos, because reading metadata from the files replaces the keywords Lightroom has.

Reading hard stamps online (optional)

For stamps this computer can't read, Datewell can also ask an online service: Claude (Anthropic), OpenAI or Google Gemini. It uses your own API key, so what it costs goes on your own account; with the usual models that's well under a dollar per thousand photos. It is off until you turn it on: in Lightroom Classic, File > Plug-in Manager > Datewell > Reading hard date stamps online. Choose the service, then click Enter API key... (a key you saved in Labelwell works too). In the standalone app, click Read hard stamps online... under the date stamp setting, choose the service, paste your key and click Save key. The app and the plug-in share the same settings and key.

Only the bottom right corner of a photo is sent, never the whole photo. By default it's sent only when Datewell sees a stamp it can't read; choose "Every photo with no date in its name" to send the corner of those too. If the online reading and what Datewell could see on this computer disagree, the photo is dated but flagged with Picture Org > Check date stamp. A chat subscription (such as ChatGPT Plus or Claude Pro) doesn't include an API key: get one from the service's developer site, as described below. On Google's free tier, Google may use what is sent to improve its products; on a paid key it does not.

Getting an API key

An API key is a long password that lets Datewell use your account with the service. A chat subscription such as Claude Pro or ChatGPT Plus does not include one: the key comes from the service's developer site, which has its own sign-in and its own pay-as-you-go billing. You only need one key, from one service, and if you already saved one in Labelwell, Datewell uses it too. The sites change their menus from time to time, so a button may be worded a little differently from what is written here.

Which one to choose

  • Claude (Anthropic) is the one we use in our own studio. It reads hard stamps well, costs well under a dollar per thousand photos, and what you send on a paid account is not used to train its models.
  • Google Gemini has a free key with no card needed, which is a good way to try reading online. On the free key, Google may use what you send to improve its products, and people at Google may look at it, so don't use the free key on photos you'd want kept private. With billing turned on, Google doesn't use what you send.
  • OpenAI works the same way as Claude: a paid account with credit added first.

Claude (Anthropic)

  1. Go to console.anthropic.com and sign up (or sign in) with your email or Google account. This is a separate account from a claude.ai chat subscription, though it can use the same email.
  2. Open Settings > Billing and click Buy credits. Add a small amount; $5 is the least you can add and lasts a long time for reading date stamps. Reading online won't work until the account has credit.
  3. Open Settings > API keys and click Create key. Give it a name you'll recognize, such as Datewell.
  4. Click Copy and paste the key into Datewell straight away (it starts with sk-ant-). The site shows the key only once; if you lose it, delete it there and create a new one.

Google Gemini

  1. Go to aistudio.google.com and sign in with your Google account. The first time, accept the terms. A work or school Google account may not be allowed to make keys; a personal Gmail account works.
  2. Click Get API key (or go straight to aistudio.google.com/apikey), then Create API key. If it asks about a project, choose to create it in a new project.
  3. Copy the key (it starts with AIza) and paste it into Datewell.
  4. The free key has daily limits, about a thousand or so readings a day, which is plenty for most jobs. To lift the limits and keep your photos out of Google's product improvement, turn on billing for the key's project in AI Studio.

OpenAI

  1. Go to platform.openai.com and sign up (or sign in). This is separate from a ChatGPT subscription.
  2. Open Settings > Billing and add credit; $5 is the usual least amount.
  3. Open API keys (platform.openai.com/api-keys) and click Create new secret key. Give it a name such as Datewell.
  4. Copy the key (it starts with sk-) and paste it into Datewell straight away; it is shown only once.

Keeping your key safe

Treat the key like a password: don't email it, post it or put it in a screenshot. Datewell keeps it on this computer only. If you think someone else has seen it, delete it on the service's site, create a new one, and paste the new one into Datewell. The service's own billing page shows what you have spent, and you can set a spending limit there.

Date prints from the date on their border

Many prints from the 1950s to the 1970s have the month and year they were developed printed on their white border, such as JUNE 1956, MAR. 1957 or JUL · 57. When a photo's name has no date, or only a year, Datewell looks for such a date along all four sides of the border, either way up. It works on a scan of the print alone and on a print photographed on a dark background. The preview shows these photos as "printed on the border", with the text it read. A border date sets the month and year. A whole date, such as June 12, 2008 printed under a school portrait, sets the day too. When the name has a year, the border date is only used if it's from that same year.

This works for JPEG, TIFF, PNG, DNG and camera raw files. Most photos take a fraction of a second; one with a hard-to-read border can take about ten seconds. Turn it off with "read a date printed on the print's border" in the settings. The lab printed the date it developed the film, which is usually a few weeks after the pictures were taken.

Date prints in an order you choose

For prints with no date anywhere, put them in order by hand and Datewell dates them in that order. In Lightroom, open the folder or collection, choose View > Sort > Custom Order and drag the photos into order. Select them and choose Library > Plug-in Extras > Date photos in their Lightroom order.

  1. Type their date (YYYY-MM-DD, for example 2004-12-01). Each photo gets that date and a time that follows its place, starting from noon: the first 12:01 PM, the second 12:02 PM, and so on. With more than 719 photos, they are a second apart instead.

  2. The preview lists every photo in order with its new date and time. Nothing is written until you click Write dates.

  3. Datewell writes the dates and Lightroom reads them back, as with Set Date Taken...

  4. Ticked by default: Lightroom's own Rename Photos then opens for the same photos. Datewell has put two templates in Lightroom's File Naming list:

    • Datewell date first puts the date in front of each name: December-0001.jpg becomes 2004-12-01_December-0001.jpg. Use it when the names already end in their number, in the same order.
    • Datewell date first sequence also adds a number in your order: IMG_0042.jpg becomes 2004-12-01_IMG_0042-0001.jpg, the next one -0002, and so on.

    Choose one and click OK. Lightroom renames the files itself, so nothing in the catalog is lost, and sorting by name, by Date taken, or by your custom order gives the same order.

If the templates aren't in the list (for example when Lightroom keeps its presets with the catalog), make Datewell date first once: in Rename Photos choose File Naming > Edit..., put in Date (YYYY), a hyphen, Date (MM), a hyphen, Date (DD), an underscore and Filename, then choose Preset > Save Current Settings as New Preset and call it Datewell date first. For the sequence one, add a hyphen and Sequence # (0001) after Filename.

Settings

The settings window lists the places Datewell looks for each photo's date, in the order it looks: a download's own files, the file's name (and its folder's), a camera's date stamp, then a date printed on the border. Below them are how dates in names are read, and the time given to dates without one.

Holidays in a name or a folder's name are worked out for the year beside them: New Year's Day and Eve, Valentine's Day, St. Patrick's Day, Easter, Mother's Day, Memorial Day, Father's Day, the Fourth of July, Labor Day, Halloween, Thanksgiving, Christmas Eve and Christmas (or Xmas).

A Google Takeout, Apple Photos or Facebook download's own files beside the photos: on by default; see above. Under it, Their date replaces a camera's own Date taken is off by default, so a camera's own date is kept.

The file's name: on by default. Turn it off to date photos only from the picture itself: the camera's orange date stamp in a corner and the date printed on the border. File and folder names are then not read at all, and the name settings below are greyed out. Use it when your names carry dates that aren't when the photos were taken, such as scan dates.

Dates like 07-04-2004: Month first (US: July 4) or Day first (7 April). When one part is over 12 the order is clear and this setting isn't needed. Until you choose, Datewell uses your computer's region: Day first in Europe and most other countries, Month first in the US and Canada.

Two-digit years like 07-04-87: the same order as above, Year first (for video capture names such as clip.04-07-04_14-23.10), or don't read them. Two-digit years below 30 are 20xx, the rest 19xx (changeable under More).

Names with only a year, or a month and year: on by default. A year alone is dated January 1, a month the 1st. Turn it off when your names carry numbers like 1987 that aren't years.

And the folder's name: on by default (from 1.7.4, and turned on once for settings saved by an earlier version). For photos such as 1987-07 Lake Tahoe/IMG_0001.jpg or Thanksgiving 1984/16-001.dng. The folder's date is used when the file's name has none, or when the folder's says more in the same year (a folder Christmas 1984 with photos named 1984-041.dng).

Name or picture first: where Datewell looks first, the file name or the picture (a camera's date stamp, then a date printed on the border). It uses the first date it finds.

  • Automatic (the default): the file name, but the picture first when the name's date is this year or the name is a photo scanner's. Those names usually give the day the photo was scanned, not when it was taken. Kodak photo scanners name each scan by the moment it was scanned, as in 20260105144811_00034A. A name like that is never used as the date in Automatic: when the picture has no date either, the photo is left undated. A name dated this year is still used when the picture has no date.
  • The file name, then the picture: the name always wins when it has a full date. The picture is read only when the name has no date, or only a year.
  • The picture, then the file name: the stamp or border date wins whenever there is one, for example when your scanner names files by the scan date. A photo scanner's name is still never used.

When the name has only a year, a date stamp or border date must be from that same year, whatever this setting says.

Camera date stamps and dates printed on the border: on by default; see the sections above. The stamp is looked for first.

Custom pattern: for unusual names. Write the pattern with YYYY or YY (year), MM or M (month), DD or D (day), hh mm ss (time), MON (a month name) and * for anything. For example Roll * DD-MM-YY reads Roll 12 25-12-65. The custom pattern is tried first.

Photos that already have a Date taken: Replace it (the default: a scanner usually writes the day of the scan) or Keep it. The preview shows both dates, and points out photos whose current date is years away from the name's.

Camera raw files: Datewell writes a .xmp sidecar file beside each raw file (IMG_0001.xmp for IMG_0001.CR2), as Lightroom and Bridge do; a sidecar that is already there is updated, keeping everything else in it. Tick "write into the raw file itself" to change the raw file instead. JPEG, TIFF, DNG, HEIC, PNG, WebP and PSD files always get the date inside the file.

Under More: also set the file's own Date modified (and Date created on Windows), also set the EXIF Modify Date, keep a copy of each photo as it was (name.jpg_original), and a time zone (for example -08:00) when you know where the photos were taken.

What Datewell writes

All to the same date and time:

  • EXIF DateTimeOriginal (what Windows calls "Date taken" and Lightroom "Capture Time") and CreateDate
  • XMP exif:DateTimeOriginal, xmp:CreateDate and photoshop:DateCreated
  • IPTC Date Created and Time Created, when the photo already has IPTC information
  • For a date from a Google download or a Facebook JSON download, the time zone it was taken in (EXIF OffsetTimeOriginal)

Only these date fields change. The picture itself is never opened or saved again, so there is no loss of quality, and the file's other information (keywords, captions, camera settings) stays as it is. Each photo is read back after writing to make sure the new date is there.

Network folders and NAS drives. Before writing, Datewell checks that each folder can be written to. A read-only folder (for example a locked or archived folder on a NAS) is left alone: its photos are listed as Not written with the reason, and the other folders are dated as usual. Some drives don't store a file's Date created; when you ask Datewell to set it and it doesn't stick, the photo says "Date created not kept" (its Date taken is still set). The app never looks through the snapshot and recycle-bin folders a NAS keeps, such as #snapshot, #recycle and @eaDir.

The app in detail

  1. Click Choose a folder (tick "Include the folders inside it" for a whole tree) or Choose photos. You can also paste or type a folder's path in the box under them and press Enter. On Windows, the folder dialog has an address bar and a Folder box you can type into. On a Mac, press Cmd-Shift-G in the dialog to type a path.
  2. Click Preview the dates. A bar shows how far along it is, which photo it's on and about how long is left. The list shows every photo: the date found (highlighted in the name), the date it has now, and what will happen. The tabs show the photos that will be dated, those with no date found, those left alone, and those with a date stamp Datewell couldn't read.
  3. Check the dates. Drag the Thumbnails slider to make the pictures bigger. For dates read from a camera's date stamp or a print's border, the part of the photo that Datewell read is shown beside the date. Click a picture to see it large: click it again (or press Space) to see it at full size, use the arrow keys for the next or previous photo, and press Esc to close it.
  4. Untick any photo you want left alone, then click Write dates.
  5. Changed your mind? Click Undo this run right away, or later choose Menu > Undo an earlier run.

Closing while it works: Menu > Quit asks first while Datewell is reading or writing: Keep working (the default) or Quit anyway, which stops after the current photo. Closing the browser tab asks too (your browser's own Leave site? question); if you leave, the work goes on to the end and the app quits by itself afterwards.

The Lightroom Classic plug-in in detail

  1. Select the photos in the Library. With only one photo selected, Datewell offers to date every photo in its folder (and the folders inside it) or just that one.
  2. Library > Plug-in Extras > Set Date Taken.... Choose the settings and click Preview.
  3. Check the preview, then click Write dates. The Pictures tab shows each photo with the date Datewell found, and for a date stamp or a border date, a close-up of the part it read. Click Larger or Smaller to change the size of the pictures. The List tab has one line for every photo.
  4. Before writing, Datewell has Lightroom save its own changes to the files (Metadata > Save Metadata to Files) and waits for it to finish. See the note below.
  5. When the dates are written, Datewell selects the dated photos and has Lightroom read the new dates from the files (Metadata > Read Metadata from Files). Lightroom's progress bar at the top left shows it working.

Why the extra steps? Lightroom keeps its own copy of each photo's information in its catalog, and doesn't let plug-ins change the capture time there. Datewell therefore writes the dates into the files, and Lightroom then reads them back, as with other capture-time plug-ins. Reading the files back replaces what the catalog has with what is in the files, so any crops (from Squarewell or by hand), keywords, ratings or captions you made in Lightroom but hadn't saved to the files would be lost. That's why Datewell has Lightroom save them first, for Undo too. When it can't do that for you, it asks you to choose Metadata > Save Metadata to Files (Ctrl+S on Windows, Cmd+S on a Mac) and click Continue; Cancel writes nothing.

On a Mac, the first time, macOS asks whether Lightroom may control your computer. That permission lets Datewell choose the menu command for you. Allow it under System Settings > Privacy & Security > Accessibility, by turning on Adobe Lightroom Classic. Until then, and whenever the automatic steps can't be done, Datewell leaves the photos selected and asks you to choose Metadata > Save Metadata to Files (before writing) or Metadata > Read Metadata from Files (after) yourself. The automatic step needs Lightroom's menus in English. You can turn it off in the settings ("Then have Lightroom read the new dates from the files").

Stopping a run: the small x on Datewell's progress bar (top left) asks first: Keep working or Stop now. Photos already dated stay dated, and the run can be undone. In the standalone app, click Stop beside the progress bar, while it reads the photos or while it writes. Stopped while reading, the preview shows the photos read so far (the rest say "Not read: stopped"), and you can write those or start again.

Each of Datewell's Lightroom windows has a User Guide button that opens this guide.

To put the old dates back: Library > Plug-in Extras > Undo a Datewell run. Lightroom reads the old dates back the same way.

Undo

Every run keeps a small undo file with each photo's old date fields (in your PictureOrg folder, "Datewell-undo"). Undo writes the old values back and removes any sidecar Datewell made. Runs made in the app and in Lightroom are listed in both.

Keyboard and Stream Deck

Every action in Datewell has a key, and the same kind of action has the same key in every -well app: F chooses a folder, G starts the main step, X stops. Anything that writes, moves, renames or deletes files needs Shift (Shift+W saves), so a stray key press never changes your files. Keys do nothing while you are typing in a box, or while a card covers the button. Press ? in the app to see the keys for the screen you're on.

The keys

A key does exactly what clicking its button does, and only when that button is on the screen.

Key Does Name for a Stream Deck button
F Choose a folder folder
P Choose photos photos
G Preview the dates go
X Stop stop
Shift+W Write dates write
Shift+U Undo this run undo-run
U Undo an earlier run... undo-list
N Start over new
1 to 9 Pick a filter tab (1 = the first) filter-1 to filter-9
Left arrow Previous photo prev
Right arrow Next photo next
Space Tick or untick this photo tick
Enter Open the photo / OK enter
Esc Close the viewer or card close
H or F1 User Guide guide
E Create an error log report
K Check my setup check
L License... license
Shift+Q Quit quit
Z Zoom zoom
? Show the list of keys keys

Stream Deck and other macro pads

Any macro pad that sends keystrokes (a Stream Deck Hotkey button, a Loupedeck, a programmable keyboard) can press the keys above while Datewell's window is in front.

For buttons that work while Datewell is behind other windows, add The Picture Org -well tools for Stream Deck, which comes with Datewell: press ? in Datewell and click Add Stream Deck buttons (the Stream Deck app, free from Elgato, must be installed). The Stream Deck app asks to install it. It adds two ready-made profiles, The Picture Org apps (a folder for each app with its window's actions) and The Picture Org in Lightroom (a folder for each app with its Lightroom commands), and two buttons under The Picture Org for building your own:

  • App action: pick Datewell and an action. The button shows the app's icon and the action's name; pressing it runs the action in Datewell, opening the app first if it isn't open. A check mark means it ran; a warning triangle means the button wasn't on the screen (or the app couldn't be reached).
  • Lightroom command: pick Datewell and one of its Lightroom commands. It runs in Lightroom Classic on the photos selected there, exactly as if you chose it from Library > Plug-in Extras. Lightroom must be open with the Datewell plug-in enabled.

To put the ready-made buttons into a profile you already use (your own Lightroom profile, say), right-click an app's folder in the ready-made profile, choose Copy, then right-click an empty key in your profile and choose Paste: the folder comes with all its buttons, and its top-left key goes back.

Other tools can do the same from a command line: Datewell --do <name> (on Windows, Datewell.exe in Datewell's folder), using the names in the tables. It only reaches the copy of Datewell running for you on this computer.

Lightroom Classic

Lightroom doesn't let a plug-in use keyboard keys or put a shortcut on its menu items, so ? works only in the Datewell app's own window. In Lightroom, click Keyboard shortcuts (in the Datewell window, next to User Guide, or in the Plug-in Manager) to see Datewell's commands and the ways to run them without the menu, and to add the Stream Deck buttons. The Datewell plug-in listens for Datewell --do lr:<name> (and the Stream Deck button) instead, on this computer only:

Library > Plug-in Extras Name
Set Date Taken... lr:set-dates
Date photos in their Lightroom order lr:order-dates
Undo a Datewell run lr:undo
Datewell: Create an error log lr:report

Your own keys in Lightroom. In the Keyboard shortcuts window, choose a key for any of Datewell's commands (for example Ctrl+Alt+Shift+C, or an F key on its own) and click Save keys. Keys are shared by all Picture Org plug-ins, so one key runs one command, and the window tells you if another plug-in already has the key you picked or if Lightroom uses it itself. The keys don't click through the menu: they hand the command straight to the plug-in, so they keep working when you add, remove or rename other plug-ins.

  • Windows: the keys work while Lightroom is the window in front, and every other program keeps them. A small helper that comes with Datewell (The Picture Org Lightroom keys) starts with Lightroom and stops a little after Lightroom closes; it never watches your typing. If another program already holds a key, the window says so: choose another.
  • Mac: your keys go into the Mac's own App Shortcuts for Lightroom Classic (System Settings > Keyboard > Keyboard Shortcuts > App Shortcuts) and work once you quit and reopen Lightroom. Any App Shortcuts you made yourself are kept.

Install

There are three downloads. The installers ask what to install: the Lightroom Classic plug-in, the standalone app (no Lightroom needed), or both. One license covers both, and you can run the installer again later to add the other.

Windows: the Setup program (ThePictureOrg-Datewell-Setup-<version>.exe)

  1. If you are installing the plug-in, close Lightroom Classic.
  2. Double-click the Setup program. If Windows shows "Windows protected your PC", click More info, then Run anyway.
  3. Accept the license, tick what to install and click Install.
  4. The app is in the Start menu as Datewell. For the plug-in, start Lightroom Classic. Select photos, then Library > Plug-in Extras > Set Date Taken...

Mac: the Install Datewell app (ThePictureOrg-Datewell-Mac-<version>.zip)

A Mac with Apple silicon (M1 or later) and macOS 13 or later. Intel Macs aren't supported: on one, the installer says so and stops. The Windows version runs on any 64-bit Windows 10 or 11 PC.

  1. Double-click the zip to unzip it. If you are installing the plug-in, quit Lightroom Classic.
  2. Double-click Install Datewell, and click Open when macOS asks. It is signed and checked by Apple.
  3. Choose what to install and click Install.
  4. The app is in Applications > ThePictureOrg. For the plug-in, start Lightroom Classic. Select photos, then Library > Plug-in Extras > Set Date Taken...

Updating and removing: run the installer from the new download the same way, or click Install now when Datewell offers an update (see Updates). Your settings and license key are kept. To remove Datewell, use Uninstall Datewell in the Start menu on Windows, or the Uninstall Datewell app in the Mac download.

Installing the plug-in by hand: on Windows, right-click ThePictureOrg-Datewell-Win-<version>.zip, choose Properties, tick Unblock, and unzip it. On a Mac, right-click Install Datewell, choose Show Package Contents and open Contents > Resources. Move the PictureOrgDatewell.lrplugin folder somewhere permanent, then in Lightroom Classic choose File > Plug-in Manager > Add and pick it. Use one way or the other, not both, or the menu appears twice.

Where it goes: the installers put the plug-in in Lightroom's own plug-in folder for your user account, where Lightroom finds it by itself (%APPDATA%\Adobe\Lightroom\Modules\PictureOrgDatewell.lrplugin on Windows, ~/Library/Application Support/Adobe/Lightroom/Modules/PictureOrgDatewell.lrplugin on a Mac). No administrator password is needed. If the Mac installer has a problem, it keeps a log for support in ~/Library/Logs/PictureOrg/Datewell-install.log.

License and free trial

  • Free trial: every feature works for 21 days on each computer. The Plug-in Manager panel and the app show how many days are left, for example "Free trial: 14 days left".
  • After the trial: for 7 more days Datewell still works, with a reminder. After that, the preview still works, and writing dates needs a license key. When a license key is needed, Datewell says "the free trial has ended" and offers Buy a license and Enter key....
  • Buying: click Buy a license in the License section of File > Plug-in Manager (select Datewell), or on the license line at the top of the app, or go to thepictureorg.com/tools. One license is for one person on up to 2 computers, covers the app and the Lightroom plug-in, and includes complimentary updates within the major version (a version 1 key works for every 1.x release).
  • Entering your key: paste the whole key from your order email into the License key box in the Plug-in Manager and click Enter key, or click the license line at the top of the app. Spaces and line breaks don't matter. It then says "Licensed to" and your name. The key is checked on this computer: nothing is sent anywhere, and no internet connection is needed.
  • Plug-in and app: one license, one free trial. The plug-in and the app share the key and the 21-day count on each computer, so a key entered in either unlocks both.
  • Bundle key: the Well Tools Bundle key covers Spoolwell, Squarewell, Pivotwell, Datewell and Labelwell. Entered in any one of them, it unlocks all of them on that computer.
  • New computer: click Remove license from this computer on the old one (it asks first; a bundle key is removed from every app in the bundle on that computer), then enter the key on the new one.
  • Where the key is kept: in your user account, not in the program's folder, so it stays through updates and reinstalling: %LOCALAPPDATA%\PictureOrg on Windows, ~/Library/Application Support/PictureOrg on a Mac.

Updates

  • Automatic check: every time Lightroom starts, and once a day while it stays open, Datewell looks up the current version number on thepictureorg.com's download service, in the background. Only that small version list is fetched: nothing about your computer, your photos or your license key is sent.
  • When a new version is out: the next time you run Datewell, a message says so once per Lightroom session: Install now (or Download), Not now (asks again next time you start Lightroom) and Skip this version (stays quiet until a later version comes out). Nothing is downloaded or installed until you click.
  • Install now: Datewell downloads the update, checks that it arrived whole and unchanged, that it carries The Picture Org's release signature and that it is newer than the version you have, and installs it into its own folder and the standalone app's (when you have both), with a progress bar. Then quit and restart Lightroom Classic to start using it. If anything goes wrong, every file is put back as it was.
  • Download: opens the installer download in your browser; close Lightroom Classic and run the new Setup program (Windows) or Install Datewell (Mac). Your settings and license key are kept either way.
  • Plug-in Manager > Updates: shows your version and whether a newer one is out, with Check now, Install update, Download installer and What's new. Untick Check for updates automatically to turn the automatic check off; Check now still works. When an update can't be installed from inside your version, the panel says to use Download installer for that one.
  • The app checks every time it opens, and Check for updates checks at any time. When a new version is out, a bar at the top lets you install it (the app installs it into its own folder, then restarts itself), download the installer, see what's new, leave it for now, or skip that version. Installing an update in either one updates both: the plug-in in Lightroom and the app. Restart Lightroom Classic afterwards if it was open.

Updates within the major version are complimentary.

Help

  • Check my setup (in the app's menu, or in File > Plug-in Manager with Datewell selected) checks that everything Datewell needs works on this computer, and shows the result as text you can copy or save.
  • Create an error log (in the app's menu, or Library > Plug-in Extras > Datewell: Create an error log) saves a text file on your Desktop with what Datewell did, then offers to send it to The Picture Org. You see exactly what would be sent before anything goes: your home folder, user name, computer name, email addresses and license key are already taken out, and you can delete anything else. Add a few words about what went wrong, and your email if you would like an answer, then click Send to The Picture Org. File and folder names are in it; your photos aren't. Nothing is sent unless you click Send. Without an internet connection, email the file instead.

Appendix: What's new

  • 1.7.5: folders that share a date each get their own hour (the first 12:xx, the next 13:xx), so their photos don't mix when sorted by time.
  • 1.7.4: writing the dates is several times faster: Datewell writes up to four photos at once, with one step a photo instead of three. Holidays in names are dated (Thanksgiving 1984 is November 22, 1984). A last number such as -001 is the photo's number, so 1985-01-001 is January 1985. The folder's name is read too, by default. The settings window lists where Datewell looks, in the order it looks.
  • 1.7.3: in Lightroom Classic, the "reading photos" box closes as soon as Datewell has read the photos, instead of staying up as "Task completed". When an update needs a full installer, Datewell checks its release signature before downloading it. The license names Washington law.
  • 1.7.2: the standalone app has a Stop button while it reads the photos, not only while it writes. Fixes "assertion failed!" when choosing Set Date Taken in Lightroom Classic.
  • 1.7.1: Datewell sticks to dates: it no longer adds a download's captions and GPS locations. Captions and places that 1.7.0 added stay on your photos; undoing a 1.7.0 run still takes them off. Facebook downloads in HTML (Facebook's default format) are read too, not only JSON.
  • 1.7.0: dates from a Google Takeout, Apple Photos, iCloud or Facebook download: Datewell reads the files the download keeps beside the photos, and can add their captions and GPS locations to photos that have none. The Check date stamp keyword is now under Picture Org, the one keyword all our apps share; once you've run this version you can delete the old Datewell keyword in the Keyword List.
  • 1.6.40: the Keyboard shortcuts window can also give a key to another plug-in's menu item, such as Negative Lab Pro, by its name. Lightroom on Windows: the Plug-in Manager's Updates box now shows its whole message. Writing dates starts sooner on large selections.
  • 1.6.39: safety improvements from our security review: on a Mac, Setup no longer clears the download check on the Lightroom plug-in, and the app only opens folders of the photos you are working on.
  • 1.6.38: choose your own keys for Datewell's Lightroom commands in the Keyboard shortcuts window; they keep working however many plug-ins you add. The Updates box in the Plug-in Manager no longer cuts off long messages.
  • 1.6.37: Datewell comes with ExifTool 13.60: Samsung HEIC motion photos stay motion photos after their dates are written, and ExifTool closes with Datewell if it is stopped unexpectedly. This update installs the full Setup.
  • 1.6.36: a whole date printed under a portrait, such as "June 12, 2008", is now read with its day (it was read as June 2012), and leafy backgrounds are no longer mistaken for a date stamp.
  • 1.6.35: date stamps and print borders are now read in DNG and camera raw files too (before, only JPEG, TIFF and PNG), and in photos turned in Lightroom. The Lightroom command is now Set Date Taken....
  • 1.6.34: a new Read dates in file names check box: turn it off to date photos only from their date stamp or border. Lightroom: a Keyboard shortcuts button in each Datewell window.
  • 1.6.33: better reading of orange date stamps made of dots, such as 1 20 '05.
  • 1.6.32: a new Which date comes first setting. By default, a name dated this year or named by a photo scanner (such as Kodak's 20260105144811_00034A) no longer wins over a date stamp or border date in the picture.
  • 1.6.31: keys for every action (press ? in the app) and buttons for a Stream Deck or other macro pad; a User Guide button in Datewell's Lightroom windows.
  • 1.6.30: closing Datewell while it works asks first (the app's Quit, the browser tab, and the x on Lightroom's progress bar); one photo selected in Lightroom offers its whole folder; the error log can be sent with one click; an online-reading API key saved in Labelwell or Sortwell works here too.
  • 1.6.29: before writing dates or undoing a run, Datewell has Lightroom save its own changes to the files, so crops (from Squarewell or by hand), keywords and captions are kept.
  • 1.6.28: version numbers now start with 1 (this follows 0.9.27). Nothing else changes, and your license key keeps working.
  • 0.9.27: the app checks for a newer version every time it opens, and Lightroom every time it starts; one update now updates both the app and the Lightroom plug-in.
  • 0.9.26: read-only network folders are reported before anything is written, and "Date created not kept" is shown when a drive doesn't store it (see What Datewell writes).
  • 0.9.25: on Windows, Setup and uninstall close a running Datewell first, so updates no longer fail on files in use.
  • 0.9.24: this guide starts with what Datewell is and a Quick start; the Plug-in Manager buttons sit on two rows.
  • 0.9.23: writing dates and Undo now say how long it took ("Took 2 min 14 s"), and an Other -well tools button joins the Plug-in Manager and the app's Menu.
  • 0.9.22: a User Guide button in the Plug-in Manager and the app's Menu opens this guide on thepictureorg.com.
  • 0.9.20: Date photos in their Lightroom order dates prints you have sorted by hand (see Date prints in an order you choose).

Earlier versions: see CHANGELOG.txt.

Appendix: License and credits

© 2026 The Picture Org LLC · thepictureorg.com. Datewell uses ExifTool by Phil Harvey to read and write dates. See NOTICE.txt.

This is the User Guide that comes with Datewell, kept up to date with each release. Questions: info@thepictureorg.com · Datewell home page · All the -well tools