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:
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.
To take it back: Edit > Undo (once for every 100 photos checked).
Next: Find sideways photos in Lightroom Classic, Check and turn photos with the app.
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.
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:
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:
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.
On each card:
Tips:
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:
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.
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.
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):
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.
The app remembers its settings for next time.
| 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. |
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)
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.
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.
%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 within the major version are complimentary.
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.
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.
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 |
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:
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 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.
Earlier versions: see CHANGELOG.txt.
| 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.
© 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