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:
Nothing is changed until you have seen a preview and clicked Write dates, and every run can be undone.
Changed your mind? Click Undo this run.
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.
| 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:
IMG_0042.jpg), or a picture number that only looks like a year (IMG_1987.jpg, DSC_2004.JPG);2004-07-04 copy of 2003-01-01.jpg) or a range (1987-1989 album.jpg);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.
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).
.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..xmp file with its date.Photo Details.csv file in each folder of photos.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.
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.
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.
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)
sk-ant-). The site shows the key only once; if you lose it, delete it there and create a new one.Google Gemini
AIza) and paste it into Datewell.OpenAI
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.
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.
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.
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.
The preview lists every photo in order with its new date and time. Nothing is written until you click Write dates.
Datewell writes the dates and Lightroom reads them back, as with Set Date Taken...
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:
December-0001.jpg becomes 2004-12-01_December-0001.jpg. Use it when the names already end in their number, in the same 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.
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.
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.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.
All to the same date and time:
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.
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.
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.
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.
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.
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 |
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:
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 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.
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)
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.
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.
%LOCALAPPDATA%\PictureOrg on Windows, ~/Library/Application Support/PictureOrg on a Mac.Updates within the major version are complimentary.
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 20 '05.20260105144811_00034A) no longer wins over a date stamp or border date in the picture.Earlier versions: see CHANGELOG.txt.
© 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