The -well tools · Pivotwell · User Guide
Pivotwell icon

Pivotwell™ User Guide

Photo Rotation Check

The guide that comes with Pivotwell 1.0.28, the current version

New to Pivotwell? Watch the 77-second introduction.

Contents
  1. What Pivotwell is
  2. Quick start
  3. Find sideways photos in Lightroom Classic
  4. Check and turn photos with the app
  5. Settings
  6. How Pivotwell decides
  7. Requirements
  8. Undo
  9. Troubleshooting
  10. Install
  11. License and free trial
  12. Updates
  13. Help
  14. Keyboard and Stream Deck
  15. Appendix: What's new
  16. Appendix: What's in the folder
  17. Appendix: License and credits

What Pivotwell is

Pivotwell finds the photos in a collection that look sideways or upside down, so you can turn them without paging through them all. It is made for digital photos from phones, cameras and family. For each photo it says which way it seems to need turning: a quarter turn right, a quarter turn left, or upside down.

Pivotwell comes two ways, with one license for both:

  • The Lightroom Classic plug-in: Library > Plug-in Extras > Check rotation flags the photos with a keyword and the purple label, and Turn the flagged photos turns them when you ask.
  • The Pivotwell app, for Windows and Mac. It opens in your web browser and doesn't need Lightroom.

Nothing is turned until you ask: the plug-in only adds keywords and labels, and the app saves turned copies, never changing the originals. For scanned prints, slides or film, Squarewell™ does the same check and also crops.

Quick start

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

In Lightroom Classic

  1. In the Library, select the photos to check: a folder, a collection or a whole import.
  2. Choose Library > Plug-in Extras > Check rotation. A progress bar runs in the top left corner.
  3. At the end a message says how many photos look sideways or upside down. Those get a Check rotation keyword and the purple label.
  4. Filter on the keyword (Text > Keywords > contains > Check rotation), look them over, then choose Library > Plug-in Extras > Turn the flagged photos.

To take it back: Edit > Undo (once for every 100 photos checked).

In the app

  1. Open Pivotwell from the Start menu, or from Applications > ThePictureOrg on a Mac. It opens in your web browser.
  2. Click Change, then Choose a folder…, and pick a folder of photos.
  3. Click Check rotation. Each photo is shown the way it will be saved, and the ones to turn are ticked.
  4. Change any suggestion with the turn buttons under a photo, then click Save. Turned copies go into a Turned folder beside the originals.

Next: Find sideways photos in Lightroom Classic, Check and turn photos with the app.

Find sideways photos in Lightroom Classic

Use this when your photos are already in Lightroom Classic. Check rotation looks at each photo the way Lightroom shows it: with Lightroom's own rotation and, if you cropped it, at the crop only.

  1. In the Library, select the photos to check. Hundreds at a time are fine.
  2. Choose Library > Plug-in Extras > Check rotation (under the gray tpo: Pivotwell™ heading). There is no dialog: a progress bar runs in the top left corner of Lightroom. Click its × to stop: Pivotwell asks first (Keep working or Stop now), and the photos done so far are kept.
  3. At the end a message says how many were checked, how many look sideways or upside down, and how long it took.

Each photo that looks wrongly turned gets a keyword under Picture Org (the one keyword all our Lightroom tools file their keywords under), saying which way to turn it, and the purple color label so it stands out in the grid:

  • Check rotation - turn right (a quarter turn clockwise: Photo > Rotate Right, Ctrl+] or Cmd+])
  • Check rotation - turn left (a quarter turn counterclockwise: Photo > Rotate Left, Ctrl+[ or Cmd+[)
  • Check rotation - upside down (turn it twice)
  • Check rotation - flip (a slide or negative scanned from the wrong side; only with Scanned slides or negatives on)

To see them: in the Library filter bar choose Text > Keywords > contains > Check rotation, click the keyword in the Keyword List, or filter on the purple label. The keywords are set not to be exported, so they never end up in your exported files.

Why it was flagged. Each flagged photo says why in its Pivotwell note, for example "Check rotation: it looks like it needs a quarter turn to the right (from the faces, 82% sure)." To see it, choose the Pivotwell view from the menu at the top of the Metadata panel. You can also search it in the Library Filter (Text > Any Searchable Plug-in Field).

How sure it is. Each photo checked also gets How sure (Pivotwell): High, Medium or Low, in the same Metadata panel view. To look at the uncertain ones first, open the Library Filter bar, click Metadata, set a column to How sure (Pivotwell) and pick Low. Lightroom can't sort the grid by a plug-in's field, so the filter is the way to gather them.

Turning them. Select the photos (or the whole folder: only those with a Check rotation keyword are turned) and choose Library > Plug-in Extras > Turn the flagged photos. After you confirm, each one is turned with Lightroom's own Rotate Left or Rotate Right, the way its keyword says, and loses its keyword, purple label and note. A backwards scan is then flipped left to right with Lightroom's own Photo > Flip Horizontal. Then Lightroom saves the turned photos' metadata into their files (Metadata > Save Metadata to Files: an .xmp sidecar beside a raw file, or inside a DNG, JPEG or TIFF), so they aren't undone by accident; programs that read orientation from the metadata can still change them. Edit > Undo takes the turns back in Lightroom (you may need it a few times); the files keep the saved turn until you save metadata again.

Or turn photos yourself and run Check rotation again on them: a photo that now looks right loses its keyword and the purple label the check gave it. A purple label you gave yourself is never removed.

Tips:

  • Look over the flagged photos before using Turn the flagged photos, and leave out any you think are wrong (remove the keyword, or don't select them). It turns what the keywords say, without looking again.
  • Lightroom has a known fault where a plug-in's rotate can turn every photo in the grid. Turn the flagged photos turns the photos that need the same turn together, and after the first group checks that no other photo in the folder or collection turned; if one did, it stops and tells you to use Edit > Undo.
  • To flag only the photos Pivotwell is quite sure of, see Settings.

Check and turn photos with the app

Use this for photos that aren't in Lightroom, or when you want to see each photo turned before saving. The app runs on your computer only: it shows its window as a page in your web browser (the address starts with http://127.0.0.1, which means "this computer"), and nothing is uploaded.

  1. Start it: Start > Pivotwell on Windows (or the desktop shortcut), Applications > ThePictureOrg > Pivotwell on a Mac. Your browser opens on the app's page.
  2. Choose photos: click Change, then Choose a folder… (tick Include subfolders to take the folders inside it too) or Choose photos… for some files. You can also paste a folder's path into the box and click Use. Last time: with Open again brings back the last folder. A folder named "Turned" (the app's own results) is skipped.
  3. Check: click Check rotation. A bar shows the progress; Cancel stops and keeps the photos done so far.
  4. Look them over: each photo is shown as a card, turned the way it will be saved. The ones that look sideways or upside down are ticked and carry a purple tag (Turn right?, Turn left?, Upside down?). The buttons above show To turn (the default), All, Not saving or Not sure, each with its count.
  5. Save: Save as shows how the photos will be saved (see Settings); click it to change. Then click Save. When it's done, Show the files opens the folder and Check more photos starts again.

On each card:

  • The turn buttons under it (None, Left, Right, Upside down) change the turn. A card you changed is marked "changed by you".
  • Flip (with Scanned slides or negatives on) flips the photo left to right after its turn. A backwards scan comes with Flip on and a purple Flip? tag.
  • The circle at the top left ticks or unticks it for saving. The … menu has Tick all shown and Untick all shown.
  • How sure the check is, out of 100: Sure (85 and up), Fairly sure (60 to 84), or an orange Not sure below 60. Least sure first puts the doubtful ones at the top.
  • Why: a line under the name gives the reason, the same words as the Pivotwell note in Lightroom.
  • Click a card to see it larger. Shortcuts there: R turn right, L turn left, U upside down, 0 none, ← → previous and next, Space save or skip, Esc back to all photos (while a photo is open these keys come first, before the ones in Keyboard and Stream Deck).

Tips:

  • The originals are never changed. A JPEG saved as JPEG is copied exactly, with only its rotation setting changed, so its quality stays the same.
  • For camera raw files, XMP sidecar beside each original turns them without making new pictures (see Settings).
  • Menu (top right) holds License, Check for updates, User Guide, Other -well tools, Create an error log, Check my setup and Quit Pivotwell. The app also closes by itself a few minutes after you close its browser tab, but never in the middle of checking or saving.
  • Quitting while it works: if you choose Quit (or close the tab) during a check or a save, Pivotwell asks first: Keep working lets it finish; Quit anyway stops after the photo it is on, keeping what is done. Minimizing the window never stops it.

Settings

Only flag when at least N% sure (off unless you turn it on). In Lightroom: File > Plug-in Manager, select Pivotwell, and under When to flag a photo tick Only flag when at least and pick 50% to 90%. In the app: on the left above Check rotation. A photo Pivotwell thinks needs turning, but is less sure of, then isn't flagged:

  • In Lightroom it gets no Check rotation keyword and the yellow label instead, and its Pivotwell note says so: "Not flagged: Pivotwell was only 52% sure, so it was not flagged (your setting asks for 70%). ..." Turn the flagged photos leaves it alone. A later run takes the yellow label off only from photos whose note still says that, so a yellow label you chose yourself stays.
  • In the app it is still shown turned, but not ticked, with a Not flagged badge. Tick it if you want it saved turned.

Profile. A named set of the settings. In the app (on the left under Photos) it holds "Only flag when at least" and everything under Save as: choose one to fill them in; Save, Save as..., Rename... and Delete do what they say; "(changed)" means the settings now differ from the profile. Three come ready to use: Flag every turned photo (as Pivotwell comes), Only the sure ones (80% or more) and Camera raw: turn in sidecars. Menu > Restore the starter profiles... puts those three back; your own are kept. In Lightroom, pick a profile from the Profile list in the Plug-in Manager under When to flag a photo to use its "Only flag when at least" setting. Profiles are kept in RotationCheck-profiles.json in the PictureOrg folder, beside the license.

Photos checked before. Pivotwell remembers its answer for each photo it checks. When you check a photo again and nothing about it has changed (the same file, turned and cropped the same way, with the same version of the check), it gets that answer back at once instead of being looked at again; the answer is always the one a fresh check would give. A photo still matches after it is moved or renamed, and a new Pivotwell release that changes how photos are checked starts afresh by itself. At the end of a run Pivotwell says how many were checked earlier, for example "412 already checked earlier, 92 checked now." To check every photo afresh anyway, tick Check again from scratch: in Lightroom in the Plug-in Manager under Photos checked before, in the app on the left under "Only flag when at least". The answers are kept in PictureOrg-answers.sqlite in the PictureOrg folder, beside the license.

Scanned slides or negatives

Off unless you turn it on. In Lightroom: File > Plug-in Manager, select Pivotwell, box Scanned slides or negatives. In the app: on the left, under "Check again from scratch". Ticking Scanned slides or negatives ticks both checks under it; untick either one you don't want. They take a few more seconds per photo.

  • Backwards scans. Pivotwell reads any writing in the picture (signs, captions, a printed date) as it is and flipped left to right, and when only the flipped reading makes real words, the slide or negative was scanned from the wrong side. In Lightroom it gets the keyword Check rotation - flip, the purple label and a note with the words it read; Turn the flagged photos flips it (Photo > Flip Horizontal) after any turn. In the app it is shown flipped, ticked, with Flip on. Photos with nothing to read are left as they are, and a photo Lightroom already shows flipped is not checked again.
  • Black & white negatives. Pivotwell finds negatives on black and white film and sets their Treatment to Black & White with the Adobe Monochrome profile (as Lightroom's own Black & White button does), so Negative Lab Pro converts them as black and white film (old film often carries a slight color cast that otherwise confuses it). They get the keyword Black & white negative and a note, but no label, since nothing is left to do. A negative Negative Lab Pro has already converted is left as it is, and Pivotwell never sets Treatment back to Color. In the app, saved as an XMP sidecar it gets the same Treatment and keyword; saved as a new picture it is made gray.

Squarewell has the same two checks, and they share their answers: a photo one of them checked is not checked again by the other.

Save as (app only):

  • New pictures, turned the right way up (the default): copies of the ticked photos.
    • Format: Same as the original where possible (JPEG stays JPEG and is copied exactly with only its rotation setting changed, even when it had no rotation setting before; HEIC becomes JPEG; PNG, TIFF and raw files become 16-bit TIFF), JPEG for every photo (smaller files, at the quality you set; JPEGs are saved again rather than copied) or always TIFF.
    • Where: in a Turned folder beside the originals, or in a folder you choose (click Choose…, or paste the path and click Use). The new picture has the original's name; a name already there gets a number, unless Replace pictures saved there before with the same name is ticked.
  • XMP sidecar beside each original: writes the purple label and the Check rotation keyword to photo.xmp next to the photo; the picture is not changed. If a sidecar is already there, only these fields are changed and a copy of the old one is kept as photo.xmp.bak. Lightroom, Camera Raw and Bridge read sidecars only for camera raw files (in Lightroom, select them and choose Metadata > Read Metadata from Files). For JPEG, TIFF and DNG files, use new pictures or the plug-in.
    • Turn camera raw files the right way up in their sidecars (on unless you untick it): for raw files the sidecar holds the turn itself, so Camera Raw and Bridge show the photo turned, and Lightroom does too after Metadata > Read Metadata from Files. Nothing in the raw file changes, and removing the sidecar puts it back.

The app remembers its settings for next time.

How Pivotwell decides

  • Faces first. Two finders look for faces at all four turns and at three sizes of the picture: OpenCV's classic one and a newer, small model from MediaPipe that also finds faces in profile, partly hidden or in black and white. Faces that are upright only one way decide the turn. A single "face" found the way the photo is shown (often a pattern in a sweater or a busy background) doesn't stop a photo being flagged when two or more faces were found the other way and the newer finder and the scene model agree.
  • The scene. Without faces to go by, a small picture model trained to tell which way up whole scenes go (buildings, people at a distance, trees and sky, food on a plate) looks at the picture at all four turns. A quarter turn it is fairly sure of is suggested; upside down only when it is all but certain.
  • Sky and horizon. When the scene model isn't sure, a horizon running top to bottom with its light, smooth side as the sky, or a bright or clearly blue sky along one side, suggests a quarter turn (never upside down).
  • How sure. Faces seen one way only score highest; a scene model that is barely sure, or a sky or horizon on its own, score lower; photos where the finders disagree score lowest. It doesn't change the answer, only how much to trust it.
  • It is a guess, tuned to avoid false flags, so it misses some: close-ups with no faces, sky or recognizable scene (a flower, a pattern, a document), and pictures taken straight down.
  • The photo's own rotation counts. The check looks at the photo turned the way its rotation setting (or Lightroom) shows it, so a photo already shown the right way up is not flagged.
  • Color of raw files: new pictures the app makes from raw files use the camera's white balance, a plain neutral rendering. For Lightroom's color, use the plug-in.

Requirements

  • Lightroom Classic (for the plug-in only), a version from the last several years. The app doesn't need Lightroom, only a current web browser (Edge, Chrome, Safari, Firefox).
  • Windows 10 or 11 (64-bit), or a Mac with Apple silicon (M1 or later) and macOS 13 or later: nothing else. Python and the image libraries are inside the download.
  • Intel Mac: not supported. Pivotwell needs a Mac with Apple silicon (M1 or later); on an Intel Mac the installer says so and stops.
  • Files: JPEG, HEIC, TIFF, PNG, DNG and camera raw files (NEF, CR2, CR3, ARW, ORF, RW2, RAF, PEF, SRW), including Lightroom's merged panoramas and HDRs. Video files are skipped.

Undo

  • Check rotation only adds and removes its keywords, the purple label, the How sure field and the note (with Scanned slides or negatives on, it also sets black and white negatives to Black & White, with the Adobe Monochrome profile). It never turns, crops or flips a photo, and Edit > Undo takes back a run in steps of 100 photos (one step for a run of up to 100).
  • Turn the flagged photos turns only the photos you chose and saves their metadata into the files; Edit > Undo takes the turns back in Lightroom (a few times), then choose Metadata > Save Metadata to Files for those photos so the files match again.
  • The app never changes the originals: delete the Turned folder, or the sidecars, to undo a save.

Troubleshooting

Message or problem What to do
A photo is flagged but is the right way up Remove the keyword and purple label in Lightroom, or set it to None in the app. Create an error log for it if you'd like it used as a test case (see Help).
A sideways photo is not flagged The check misses some (see How Pivotwell decides). Turn it by hand. Photos rated Low (or Not sure in the app) are where misses are most likely.
Nothing under Plug-in Extras after installing Quit Lightroom Classic completely and start it again: it looks in its plug-in folder only when it starts. In File > Plug-in Manager, Pivotwell should be listed and enabled; if it is disabled, click Enable.
Check rotation appears twice under Plug-in Extras Either it is installed twice (once by the installer, once added by hand: remove the hand-added entry in the Plug-in Manager), or Squarewell is installed too, whose menu has its own Check rotation only. Both give the same answers.
"The bundled Python (python-win folder) is missing" The folder was moved or partly copied. Run the installer again, or unzip the plug-in again, all of it.
"Python 3 was not found" or "image libraries are missing" (Mac) Download Pivotwell again and open Install Pivotwell. Pivotwell needs a Mac with Apple silicon (M1 or later).
Apple silicon Mac, installed by hand: macOS says the plug-in's Python can't be opened Go to System Settings > Privacy & Security, click Open Anyway, then run the check again.
A photo is listed under "Not checked" The file could not be read (damaged, or a type it doesn't read). The reason is in the message; details are in rotationcheck-log.txt, whose full path the message gives.
Turn the flagged photos says it stopped and to use Undo Another photo turned along with the chosen one (a Lightroom fault). Use Edit > Undo right away until the turns are back, then turn the rest with Photo > Rotate Left or Rotate Right, and send us an error log.
Turn the flagged photos says the turns could not be saved into the photo files The turned photos are left selected: choose Metadata > Save Metadata to Files in the Library. On a Mac, allow Lightroom Classic under System Settings > Privacy & Security > Accessibility (macOS asks the first time), and it is done for you next time. It also needs Lightroom's menus in English.
Turn the flagged photos says Lightroom can't turn photos from a plug-in Your Lightroom version lacks this. Turn them by hand; the keyword says which way.
"That key is not valid" Paste the whole key from your order email, including the dot in the middle. Spaces and line breaks don't matter. A key for another -well tool works only if it is the bundle key (see License and free trial).
The app: nothing opens, or the page says to open it from its shortcut Start it from its shortcut (Windows Start menu, Mac Applications); it opens the page with its own address. Close any browser tab left from an earlier session. If nothing opens at all, look at the end of RotationCheck-app-log.txt in the PictureOrg folder (%LOCALAPPDATA%\PictureOrg on Windows, ~/Library/Application Support/PictureOrg on a Mac).
The app: "Choose a folder" does nothing The folder window may have opened behind the browser: look in the taskbar or Dock. Or paste the folder's path into the box and click Use.
Lightroom doesn't show the keyword from an app sidecar Sidecars are read only for camera raw files, and only when Lightroom reads metadata: select the photos, Metadata > Read Metadata from Files. For JPEG, TIFF and DNG, save new pictures or use the plug-in.

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-Pivotwell-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 Pivotwell. For the plug-in, start Lightroom Classic. Select photos, then Library > Plug-in Extras > Check rotation.

Mac: the Install Pivotwell app (ThePictureOrg-Pivotwell-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 Pivotwell, 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 > Check rotation.

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

Installing the plug-in by hand: on Windows, right-click ThePictureOrg-Pivotwell-Win-<version>.zip, choose Properties, tick Unblock, and unzip it. On a Mac, right-click Install Pivotwell, choose Show Package Contents and open Contents > Resources. Move the PictureOrgRotationCheck.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\PictureOrgRotationCheck.lrplugin on Windows, ~/Library/Application Support/Adobe/Lightroom/Modules/PictureOrgRotationCheck.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/RotationCheck-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 Pivotwell still works, with a reminder. After that, it stops checking new photos. Keywords and labels already added stay as they are. When a license key is needed, Pivotwell 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 Pivotwell), 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.

Pivotwell and Squarewell are separate products with separate keys: a Pivotwell key on its own does not unlock Squarewell, and the other way round. The bundle key unlocks both.

Updates

  • Automatic check: every time Lightroom starts, and once a day while it stays open, Pivotwell 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 Pivotwell, 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: Pivotwell 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 Pivotwell (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 Pivotwell selected) checks that everything Pivotwell 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 > Photo Rotation Check: Create an error log) saves a text file on your Desktop with what Pivotwell 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.

  • Pictures with an error log (optional): tick Include small pictures of the problem photos in its window to add a small picture of each selected photo (in the app: the photos flagged, not checked, changed by you or not sure), up to 50, each as it is shown and as Pivotwell would turn it, with the reason underneath. The text and the pictures then come as one zip file. When you send it, the pictures go only if you tick Also send the small pictures. The box is off each time, because the pictures show your photos.

Keyboard and Stream Deck

Every action in Pivotwell 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 Check rotation go
X Cancel stop
Shift+W Save write
N Check more photos new
O Show the finished files open
A Tick all shown tick-all
Shift+A Untick all shown untick-all
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
T Settings settings
Shift+Q Quit quit
R Open again (the last run) again
0 No turn turn-none
] Turn right turn-right
[ Turn left turn-left
Shift+0 Upside down turn-upside
V Where and how to save save-options
? 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 Pivotwell's window is in front.

For buttons that work while Pivotwell is behind other windows, add The Picture Org -well tools for Stream Deck, which comes with Pivotwell: press ? in Pivotwell 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 Pivotwell and an action. The button shows the app's icon and the action's name; pressing it runs the action in Pivotwell, 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 Pivotwell 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 Pivotwell 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: Pivotwell --do <name> (on Windows, Pivotwell.exe in Pivotwell's folder), using the names in the tables. It only reaches the copy of Pivotwell 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 Pivotwell app's own window. In Lightroom, click Keyboard shortcuts (in the Pivotwell window, next to User Guide, or in the Plug-in Manager) to see Pivotwell's commands and the ways to run them without the menu, and to add the Stream Deck buttons. The Pivotwell plug-in listens for Pivotwell --do lr:<name> (and the Stream Deck button) instead, on this computer only:

Library > Plug-in Extras Name
Check rotation lr:check
Turn the flagged photos lr:turn-flagged

Your own keys in Lightroom. In the Keyboard shortcuts window, choose a key for any of Pivotwell'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 Pivotwell (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.

Appendix: What's new

  • 1.0.28: updates that need the full installer check its signature first; Cancel stops a check right away and a photo that takes over 10 minutes is skipped; the app keeps checked photos for a day while they wait to be saved.
  • 1.0.27: the rotation check also reads any writing in the picture, so a sign or caption photographed sideways is turned by its text; on a Mac, Pivotwell needs Apple silicon (M1 or later).
  • 1.0.26: black & white negatives now show in black and white (they get the Adobe Monochrome profile, as Lightroom's own Black & White button gives them), and the keywords are filed under Picture Org, the one keyword all our Lightroom tools share. Earlier versions filed them under Rotation Check: once you've run this version, you can delete that keyword in the Keyword List.
  • 1.0.25: a new Scanned slides or negatives setting finds backwards scans (and Turn the flagged photos flips them) and black & white negatives (Treatment set to Black & White for Negative Lab Pro). Pivotwell and Squarewell share their rotation answers, and Pivotwell runs on Python 3.13, the same as Squarewell.
  • 1.0.24: Check rotation and Turn the flagged photos are much quicker on large selections, the error log window matches Squarewell's, and the Keyboard shortcuts window can also give a key to another plug-in's menu item, such as Negative Lab Pro.
  • 1.0.23: the Updates box in the Plug-in Manager now shows its whole message on Windows too.
  • 1.0.22: security fixes from a code review: the app only opens files from your own run, and the shared parts are up to date.
  • 1.0.21: finds more sideways portraits (such as prints on a black background), the Updates box in the Plug-in Manager no longer runs off the edge, Setup uses the same names for what it installs as every Picture Org app, and uninstalling can also remove your Pivotwell settings and logs.
  • 1.0.20: a photo checked before, and unchanged since, gets its answer back at once instead of being checked again, with Check again from scratch to look at every photo afresh.
  • 1.0.19: keys for every action and Stream Deck buttons, a question when only one photo is selected in a chosen folder, a warning before quitting mid-run, and a User Guide button in the window at the end of each run.
  • 1.0.18: Turn the flagged photos saves the turns into the photo files, Create an error log offers to send the report for you, Pivotwell checks for updates every time it opens, and an update from the app or the plug-in updates both.

Earlier versions: see CHANGELOG.txt.

Appendix: What's in the folder

File or folder Purpose
Info.lua Tells Lightroom about the plug-in: its name, version and menu items.
CheckRotation.lua, TurnFlagged.lua, RotationRun.lua The Check rotation and Turn the flagged photos commands.
MetadataDefinition.lua, MetadataTagset.lua The How sure (Pivotwell) field and the Pivotwell note in the Metadata panel.
PluginInfoProvider.lua, logo.png, manager-icon.png The Pivotwell panel in File > Plug-in Manager.
Update.lua, Init.lua, License.lua, ReportMenu.lua, Diag.lua, PO*.lua, Json.lua, Profiles.lua Updates, the free trial and license key, the error log, and the code shared with the other -well tools.
helper\rotation.py The helper program that looks at each photo. Lightroom runs it in the background.
helper\orient.py, helper\photoload.py, helper\heic.py, helper\data, helper\jxl The rotation check itself, the photo readers and the face and scene models, the same as Squarewell's.
helper\app.py, helper\app_render.py, helper\app_ui.html, app-icon.ico, app-icon.icns The standalone app.
helper\po_license.py, helper\update_apply.py The license check (on this computer; nothing is sent) and installing updates.
python-win, python-mac Python and its image libraries for Windows, or for Apple silicon Macs. Nothing to install.
runtime.json Which Python and libraries this copy has, so an update knows whether it needs the full installer.
third-party-source Source code of rawpy, LibRaw, libheif and libde265, which their licenses ask to be made available.
docs This guide (Markdown and HTML), and a one-page cheat sheet (HTML and PDF).
README.txt, CHANGELOG.txt, LICENSE.txt, NOTICE.txt Quick start, version history, license, third-party notices.

Keep the folder together: the plug-in looks for the helper and Python inside its own folder. Logs are in the PictureOrg folder (%LOCALAPPDATA%\PictureOrg on Windows, ~/Library/Application Support/PictureOrg on a Mac): RotationCheck-app-log.txt for the app and rotationcheck-log.txt for the check.

Appendix: License and credits

© 2026 The Picture Org LLC · thepictureorg.com. Free 21-day trial, then a license key is needed (see License and free trial); not to modify or resell; see LICENSE.txt. Includes Python (PSF License), NumPy (BSD), OpenCV (Apache 2.0), rawpy (MIT), LibRaw (GNU LGPL 2.1), pi-heif (BSD) with libheif and libde265 (GNU LGPL 3), Pillow (MIT-CMU) and a face-detection model from MediaPipe (Apache 2.0); see NOTICE.txt. Pivotwell and Squarewell are trademarks of The Picture Org LLC. Adobe and Lightroom are trademarks of Adobe Inc.; other names are trademarks of their owners.

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