Squarewell finds the slide, print, negative or document in each of your photos and scans, straightens it and crops away the background, whether you shot it on a black background, a white background or a copy stand. It also splits a photo of an album page into one cropped photo for each print on it. It is made for anyone digitizing slides, prints, negatives and albums with a camera or a scanner.
Squarewell comes two ways, with one license for both:
In Lightroom, Squarewell changes only Lightroom's crop settings, keywords and color labels, never your files, and Edit > Undo takes back a run (once for each 100 photos). The app never changes your originals.
Changed your mind? Edit > Undo Squarewell takes back the whole run. A run of more than 100 photos is saved 100 photos at a time, so choose Undo once for each part (they show as Squarewell (1 of 3) and so on).
Your originals are never changed, so to start again, delete the Auto Crop folder.
Next: Crop and straighten slides and prints, Crop film negatives, Crop album pages into separate photos, Crop prints with borders or card mounts, Find and turn sideways photos, Check every crop before saving, with the app.
Use this for slides, prints, magazines and documents photographed or scanned one to a photo.
What you get: each photo is straightened and cropped to the picture, leaving out the background, the slide mount and, if you like, a print's white border. Each photo that gets a color label, or isn't cropped, keeps the reason in its Squarewell note (see Labels, keywords and notes). To undo, see Undo.
Time: roughly 3 to 4 seconds a photo, one at a time, on a typical PC. A computer with four or more cores looks at two or three photos at once (each takes about 1 GB of memory, so fewer when memory is short), which makes a run about 1.7 times faster on four cores and more on eight. The crops are the same either way. Memory use does not grow with the number of photos, and a few hundred photos a run is comfortable.
Capturing for the best results:
Use this for negative strips photographed in a carrier (such as a Negative Supply carrier). Crop the raw negatives before you invert them (in Negative Lab Pro or by hand): converters judge the color from what's inside the crop, so the film rebate and sprocket holes are best left out.
How it works: on a negative the picture is darker than the clear film base around it (the rebate and the gaps between frames). Squarewell measures the film base right beside the sprocket holes, then finds each edge where the film gets darker than that, in 12 stretches a side. It looks past a neighboring frame that shows at the side of the capture. Stretches that don't line up are left out, and a side that disagrees with the others on the straighten angle is dropped.
Frames whose edge can't be seen: deep shadows are nearly clear on a negative, so an edge running through them can be invisible (dark trees along two sides, say). The sprocket holes are the guide. A camera moves the film exactly 8 holes a frame and holds it at a fixed height, so on one roll every frame sits in the same place relative to the holes. The frames whose edges can be seen give that place and the frame size, and Squarewell uses them for any side it can't find. These are measured in sprocket-hole spacings, so a strip shot partly close up and partly wider still crops right. With fewer than three good frames it uses the 3:2 shape of a 35mm frame (or the film format chosen) from the opposite side, and on the sprocket side it crops just inside the holes. A gap side with nothing to go on is cut at the capture's edge.
Mixed with other photos: a 35mm negative selected along with slides or prints (a row of sprocket holes along a side) is found and cropped as a negative even with File content left at Slides, prints, magazines or documents, using the other negatives in the selection for the frame size.
On a black background: a strip or sheet lying on a black background (a light box with the area round the film masked off), with no sprocket holes to go by, is cropped as a print on black is: to the picture itself, with the film's clear or fogged edge left out, even with Crop off print borders unticked. On white card or a light table, a sheet negative is cropped inside the film's pale clear edge, leaving out a dark fogged band or the next frame's edge beyond it.
White balance from the film base (off unless you tick it, on the Cropping tab in Lightroom, or with XMP sidecars in the app): Squarewell also sets each frame's white balance from the clear film around it, the way you would with the white balance dropper on the film edge, in the same step as the crop. The whole roll then starts out neutral, ready to convert as a group. A frame with no clear film showing takes the white balance of the other frames in the run. It works on raw files only (a JPEG or TIFF keeps its white balance), and not on album pages.
Black-and-white negatives (on unless you untick Black & White for black-and-white negatives): Squarewell recognizes negatives shot on black-and-white film and sets their Treatment to Black & White in the same step as the crop, before you convert them. Old black-and-white film often carries a slight color cast that throws off a converter's color model; with Treatment set to Black & White first, Negative Lab Pro converts them as black and white. They also get the keyword Black & white negative. It looks past the orange or purple tint of the film base, so color film is never set to Black & White; a frame too close to call is left as it is. A negative already converted keeps its colors. In the app it works with XMP sidecars, and a saved JPEG or TIFF of a black-and-white negative is saved in gray.
Negatives you have already cropped: to set just the white balance, select them and choose Library > Plug-in Extras > Set white balance only (negatives). Each one gets its white balance from the clear film around the crop it already has; a frame with no film base showing takes the middle value of the others in the selection. Nothing else changes: no crop, keyword or label. Photos with no crop yet, and negatives already converted, are skipped. Edit > Undo takes it back.
Negatives already converted: when the selection holds negatives already turned into positives (by Negative Lab Pro, or inverted with the tone curve), Squarewell asks first: Crop them too or Skip them. A new crop doesn't change their colors, and their white balance is left as it is. Only if you go back into Negative Lab Pro to adjust a frame's color does it work from the new crop. With Replace crops already made unticked, a converted frame that already has a crop is still left as it is. A Positive Copy made by Negative Lab Pro is an ordinary positive and is cropped like any other. In the app, a converted negative's XMP sidecar takes the new crop and keeps its colors, and the message after saving says how many there were.
Every frame matches the roll: frames from one roll share one size. Once every frame is cropped, each is checked against the frames just before and after it, in file-name order. A crop that is not their size (within about 1.5%) is drawn at their size, on the side of its own that agrees with them, or, in a film carrier, where the frames beside it sit. It gets the yellow label, the keyword Check crop and a note saying what happened, so you only need to look at those frames. To fix one, move the crop; its size is already right. A frame whose picture runs off the edge of the capture is not shrunk to the others' size, and a frame far from their size (another format) is marked and cropped as found. Frames from different rolls side by side don't agree with each other, so nothing is changed there.
Fogged film edges: a negative whose film edge is fogged dark is cropped loosely and straightened. Only the sides with clear film beside the picture can be found, so some of the fogged edge may show. Its Squarewell note says "fogged film edges", so you can find and check these. A frame where nothing can be found with confidence is left uncropped rather than given a steep, wrong straighten angle.
Disc film: a Kodak Disc frame photographed in its holder is found as the picture's rectangle (about 10 x 8 mm) inside the plain band of film round it, leaving out the holder, the frame numbers and the disc's rim. It works with Film negatives or Slides, prints, magazines or documents chosen, and with Disc chosen as the film format the disc frame is looked for first. Disc frames are measured one by one, so they don't need to be selected together.
Not used for negatives: print border trimming, Crop inside rounded or mounted corners, the dark-edge rule at 0 and above on Crop edge, and the rotation flags (the picture is a negative, so the face and sky checks don't work on it). The Crop edge setting still applies.
Limits: Film negatives is made for strips of 35mm captured with a camera in a carrier that shows the sprocket holes. A film format helps with other sizes (120, 4x5), but light-table captures, other film sizes and color slides in strips are still being tested; send samples to The Picture Org.
A slide or negative photographed from the wrong side comes out mirrored: writing reads backwards. With Flip slides and negatives scanned backwards ticked (the default, for Film negatives and Slides, prints, magazines or documents), Squarewell reads any writing in each cropped picture, as it is and mirrored (and both upside down). Signs, shop names, logos, captions and dates all count, in English, Spanish, French, German, Italian, Portuguese, Dutch, Swedish and Polish. When the mirrored reading is clearly the real one, the photo is flipped left to right (Lightroom's Photo > Flip Horizontal), gets the keyword Scanned backwards (flipped), and its Squarewell note says what was read. For a negative the picture is read as a positive for the check only; nothing is inverted or saved.
Use this for a photo or scan of an album page (a black or dark page, a light page or grid, a flatbed scan) that holds several prints. Squarewell finds each one and makes it a photo of its own.
What you get:
How prints are found:
Borders and writing on album prints:
Running again: pages that already have their "Photo" copies are skipped, unless Replace crops already made is ticked. Then the copies are cropped again, and new copies are made only for prints found this time that have none. Edit > Undo takes the crops back; the copies themselves stay (delete them in the Library if needed).
Time: about 3 to 10 seconds a page, more with many prints.
Limits: prints laid edge to edge with no visible line between them, and prints on a page of the same color as their borders, may be taken as one. A heavily fanned stack gives narrow strips.
Crop off print borders is on by default: it trims a print's light, even border, on every side that has one, and a studio portrait's card mount, so the crop goes to the picture inside. Untick it to keep a border with handwriting or a printed date on it, or a mount with the photographer's imprint: with it ticked, writing on the border goes with the border.
What counts as a border: a light, near-neutral, even band along a side that ends in a clear step into the picture. Each side is checked on its own, so a print with a border on only two sides has just those two trimmed.
Crop inside rounded or mounted corners moves each side in just far enough that no corner shows (at most 15% of the short side). It finds black photo corners on a black album page even where they blend into the page. The crop is a little smaller, so leave it off for square-cornered items. A print with a corner cut away far more than that (a school photo cut round at the bottom, say) is treated as an irregular shape instead, so the picture is not cut into (see Irregular shapes).
Everything is captured in landscape, so pictures taken in portrait arrive sideways. With Flag photos that look sideways or upside down ticked (the default), Squarewell flags photos that look wrongly turned with the purple label and a keyword under Picture Org. Nothing is rotated:
Squarewell goes by the faces, the scene, the horizon and the sky, and by any writing in the picture (1.6.82): a sign, a caption or a shop name that reads clearly one way settles which way up the photo is, even when the sky or a wall suggests otherwise. The writing is read when a photo is about to be flagged or nothing else was sure of it. With Flip slides and negatives scanned backwards ticked, the writing read for that check is used for the rotation too, so it costs no extra time.
To check photos you have already cropped, choose Library > Plug-in Extras > Check rotation only. It checks whether each selected photo looks sideways or upside down, and nothing else: no crop, straighten angle or rotation is changed, so cropped photos are checked as cropped. It starts at once, with no dialog, and gives the same keywords and purple label; photos that look the right way up lose them. Edit > Undo takes the run back.
To turn the flagged photos:
Nothing in the file changes, and Edit > Undo turns the photos back (once for each photo). As a safeguard against an old Lightroom bug that turned every photo in a filtered grid, the first turn is checked: if any other photo turned with it, it stops and tells you to use Undo. The keywords are never included in exported files. In the app, the Check rotation only button does the same (see Check every crop before saving, with the app).
How it decides:
Limits: it is a guess, tuned to avoid false flags, so it misses some: scenes with no people, sky or horizon (a ferry from above), a print of a standing figure whose face it can't find, magazines and documents. The direction is relative to how the photo is shown in Lightroom when Squarewell runs. If you turn a photo in Lightroom afterwards, remove its keyword by hand, or run Check rotation only again.
A photo checked before isn't checked again. Squarewell remembers each rotation answer on this computer. When the same photo, unchanged and cropped the same way, comes up again (in Auto Crop or Check rotation only, even after the file was moved or renamed), it uses that answer instead of checking again, so a second run is quicker. The crop is remembered too: a photo run again with the same settings is not measured again. The answer is always the one the check would give. The end-of-run message says how many were checked earlier and how many now. To check every photo again, tick Check rotation again from scratch (in the app: More options). After an update that changes the check, every photo is checked afresh.
The app does what the plug-in does, without Lightroom, and lets you see every crop before anything is saved. It runs on your computer only: it is a small program that shows its window as a page in your web browser (the address starts with http://127.0.0.1, which means "this computer"). Nothing is uploaded; the page only talks to the program on your computer.
Starting it: on Windows, Start > Squarewell (or the desktop shortcut). On a Mac, Applications > ThePictureOrg > Squarewell. Your browser opens on the app's page; opening it again while it runs just shows the same page. The gear at the top right is the app's menu: License…, Check for updates, User Guide, Other -well tools, Restore the starter profiles…, Check my setup…, Create an error log… and Quit Squarewell. The ? opens this guide, and the trial or license line opens the license panel. The app also closes by itself a few minutes after you close its browser tab, but never in the middle of finding or saving. While it is finding or saving, Quit Squarewell and closing its browser tab ask first: Keep working lets it finish, Quit anyway stops after the current photo (what is done stays done). Minimizing the window never asks.
The app is one screen: the choices on the left, the results in the middle, and saving along the bottom.
1. Photos (left). 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. On Windows the folder window has an address bar and a Folder box, so you can type or paste a path there; on a Mac, press Cmd-Shift-G in the folder window to type one. The folder's name and the number of photos are shown. The app remembers the last folder you used, even after it is closed: it shows Last time: with that folder and an Open again button, and the folder windows open there. JPEG, HEIC (iPhone photos), TIFF, PNG, DNG and camera raw files are used. A folder named "Auto Crop" (the app's own results) is skipped.
Profile (left). Under Photos is the Profile list, with Save, Save as…, Rename… and Delete. The profiles are the same ones as in the plug-in (see Profiles): choosing one fills in the settings below, and "(changed)" shows beside Profile after you change one, until you save it.
2. File content, and Crop (left). Choose Negatives (see Crop film negatives), Slides, prints (slides, prints, magazines or documents) or Albums (album pages, which may be mixed with single prints). For negatives and slides, Film format (Image format for slides and prints) works as in the plug-in (see Film format and Image format); with Custom ratio, type the long side over the short (1.5 or 3:2). Then the common options: Crop off print borders and Flag sideways photos. More options holds the crop edge (a box and a slider), crop inside corners and Leave unsure photos uncropped. They work as in the plug-in (see Settings); point at one for a short explanation. Then click Find crops (afterwards, Find crops again). A bar shows the progress; Cancel stops and keeps the photos done so far. When it's done, the message says how long it took.
Check rotation only: the button under Find crops only checks whether each photo looks sideways or upside down. Nothing is cropped: each card shows the whole photo, turned the way Squarewell suggests, and only the photos to turn are ticked. Open a card to change the turn (None, Right, Upside down or Left). Save then makes new pictures turned the right way up (whole, not cropped), or with XMP sidecar writes only the purple label and the "Check rotation" keyword, keeping any crop the sidecar already has. For a camera raw file the sidecar can also turn the photo itself (Turn camera raw files the right way up in their sidecars, on by default; not for DNG files): Lightroom, Bridge and Camera Raw then show it the right way up after Read Metadata from Files, and its "Check rotation" keyword and purple label come off.
3. Check the crops. Every crop is shown as a card with the cropped result. A colored tag at the top right is the same flag as in Lightroom: purple "Turn left?", "Turn right?" or "Upside down?" (nothing is turned); blue "Kept whole", an album print kept whole for the writing on its border; green "Odd shape", an irregular shape cropped to the box around it. A line under each flagged photo says why in plain words, and so does the list of photos not cropped.
4. Save (bottom). Save as shows how the crops will be saved; click it to change:
photo.tif; album pages page - Photo 1.tif, page - Photo 1 note.tif as in Lightroom. A name already there gets a number, unless Replace pictures saved there before is ticked. A JPEG keeps the original's camera data (EXIF, its orientation set to upright, since the new picture is already turned the way the photo is shown) and color profile; a TIFF keeps the color profile. Each new picture also carries its color label in standard XMP fields, which Lightroom, Bridge, Mylio and most photo programs read. The flag keywords ("Check rotation - turn left", "Irregular shape") are written only to XMP sidecars, never into a saved picture, so they can't leave with it.photo.xmp next to the photo, in Camera Raw's own crop fields, with the color label and keywords (filed under Picture Org, so Lightroom keeps them under its non-exporting Picture Org keyword). The picture itself is not changed. If a sidecar is already there (say one Lightroom wrote), only these fields are changed and a copy of the old one is kept as photo.xmp.bak. When two chosen photos share a name (IMG_1.jpg and IMG_1.dng), the JPEG's sidecar is IMG_1.jpg.xmp. Album pages with several prints always get new pictures, since one sidecar holds one crop.Then click Save N photos (bottom right; it shows how many are ticked). When it's done, Show the files opens the folder and Crop more photos starts again. The originals are never changed or replaced.
Which programs read the sidecar crop: Adobe Camera Raw, Bridge and Lightroom Classic read .xmp sidecars for camera raw files (NEF, CR2, CR3, ARW and so on). In Lightroom, select the photos and choose Metadata > Read Metadata from Files (or import them after the sidecars are written). For DNG, JPEG and TIFF files Adobe's programs read only what is inside the file, not a sidecar, so choose New cropped pictures for those, or use the Lightroom plug-in. The save panel says so when none of the chosen photos is a camera raw file. Other programs vary (see Use Squarewell with Mylio and other programs).
Color of raw files: new pictures made from raw files are converted by the app with the camera's white balance, a plain neutral rendering. For the color you would get from Lightroom or Camera Raw, use the plug-in, or the sidecar way for camera raw files.
Settings (the options, the profile and the save choices) are remembered for next time.
The plug-in's crop is Lightroom's own crop setting. After each run, Squarewell has Lightroom save the cropped photos' metadata to their files, as Metadata > Save Metadata to Files does: into an .xmp sidecar beside a raw file, or into the DNG, JPEG or TIFF file itself (the picture itself isn't changed). So another program that writes to the same files, or a later Read Metadata from Files, keeps the crop instead of replacing it with an uncropped one, and other programs can see it.
Under Library > Plug-in Extras there are also Auto Crop now: slides and prints, Auto Crop now: film negatives and Auto Crop now: album pages. Each one starts at once, with no dialog, with its own kind of photo. It uses the profile chosen for it in File > Plug-in Manager > Profiles, or else the profile last chosen in the dialog (see Profiles); with no profile chosen, it uses the options you last chose in the dialog. The first time you use one, it lists those options and the profile and offers Check settings (opens the dialog), Run now or Cancel; it asks only once.
Give each one a keyboard shortcut to crop a batch in one keystroke:
Auto Crop now: slides and prints) and press the keys you want.In the app, every action has a key; press ? to see them. A Stream Deck or other macro pad can run the app's actions and the plug-in's commands in Lightroom: see Keyboard and Stream Deck.
At the top of the Auto Crop & Straighten... dialog is the Profile row (see Profiles). Below it, the dialog says: "Images of different sizes can be mixed freely. If you group slides or negatives of the same size and type, they can be cropped more accurately, as they can be checked against each other." (see The batch check). Then come File content and Film format (Image format for slides and prints).
Under these the dialog has two tabs: Cropping (print borders, the rotation flag, and replacing crops already made) and Album pages (the TIFF copies, and the Cropping settings again, which apply to album pages too: changing one changes the other). The tab follows File content, and you can still click the other one. Fine-tuning... is a button below the tabs that opens a small window for the crop edge and crop inside corners: OK keeps your changes, Cancel puts them back. A gray line beside it sums up the album and fine-tuning settings, so nothing is hidden. Point at an option for a short explanation.
| Option | Default | What it does |
|---|---|---|
| File content | Slides, prints… | Film negatives for camera captures of negative strips (see Crop film negatives); the border and rotation options are grayed out then. Slides, prints, magazines or documents for one item to a photo. Slides only (1.6.82) for a run of slides: the same, but no photo is taken for a deckled print (Keep deckled edges is grayed out) or for a page of prints, a slide's dark ground (a sunset over dark hills) is kept with the sky, and Image format lists only film formats. Use it for runs of slides. Album pages (several photos on each) for pages holding several prints (see Crop album pages into separate photos). |
| Film format (Image format for slides and prints) | Auto | For negatives and slides (grayed out for album pages). Auto learns a negative's frame size from the strip. Or choose the format the film was shot in, a print size or an instant print, or Custom ratio (see Film format and Image format). |
| Album pages: also save each photo as a 16-bit TIFF | Off | Album pages only: each photo found is also saved as a TIFF file beside the page and stacked with it. |
| Crop off print borders | On | Trims a print's light, even border on every side that has one, and a portrait's card mount, even when there is handwriting or a printed date on it. To keep writing or other notes on a border, untick it so the whole border is kept (see Crop prints with borders or card mounts). |
| Keep deckled edges | On | With Crop off print borders ticked, a print with a deckled (scalloped) edge keeps its whole border, cropped out to the scallops' tips. Untick it to trim deckled prints like any other. |
| Crop edge | Trim in 0.30% (shown as -0.30) | A slider from Trim in (up to 3%) through 0 (on the edge) to Leave a margin (up to 4%), with the number beside it, as a share of the short side. Left of 0 moves every side in, so no thin line of background shows. At 0 the crop sits on the edge found, and where the picture is dark against an edge (a dark boat or shoreline running right to a slide mount) the crop goes to the outer end of the edge's soft fall-off. Right of 0 leaves that much of the background showing all round, so nothing at the picture's edge is lost. A thin dark line may show along some edges at 0 and above. It works together with Crop inside rounded or mounted corners: the corners are cleared first, then the crop moves in or out from there by this setting. |
| Crop inside rounded or mounted corners | Off | For prints with rounded corners, or held by black photo corners or a mount whose corners overlap the picture. Each side moves in just far enough that no corner shows (at most 15% of the short side). Not used for negatives. |
| Flag photos that look sideways or upside down | On | Adds a "Check rotation" keyword and the purple label to photos that look wrongly turned. Nothing is rotated (see Find and turn sideways photos). |
| Black & White for black-and-white negatives | On | Film negatives only: sets Treatment to Black & White on negatives shot on black-and-white film, before you convert them, with the keyword Black & white negative (see Crop film negatives). |
| Flip slides and negatives scanned backwards | On | Negatives, slides and prints (not album pages): reads any writing in the picture and flips a photo whose writing reads backwards, with the keyword Scanned backwards (flipped) (see Slides and negatives scanned backwards). Adds a few seconds a photo. |
| Check rotation again from scratch | Off | Checks every photo's rotation again, and measures its crop again, instead of reusing the answers saved from an earlier run on the same photo. |
| Replace crops already made | Off | Off: photos that already have a crop or angle are skipped, so your own crops are safe. On: they are cropped again. |
| Leave unsure photos uncropped (yellow label, with the reason in its note) | Off | When a photo's edges barely show against the background, the photo is left as it was instead of guessed at. It gets the yellow label and a note saying why, for example "Not cropped: Squarewell was not sure of the edges (…), so the photo was left as it was." On an album page only the doubtful print is left out. Unticked (the default), such a photo is cropped and gets the yellow label and the keyword Check crop instead. A later run that crops the photo takes the yellow label off. For film negatives it works only with a film format chosen: a frame that doesn't fit the format is then left uncropped. |
| Build Standard previews of the cropped photos when done | Off | Lightroom only. After the crops are set, Lightroom builds a Standard preview of each cropped photo (and each album copy), so the grid and Loupe show the new crops at once instead of "Loading". The size beside it should match Catalog Settings > File Handling > Standard Preview Size in Lightroom, so the preview is kept (Auto works it out from your screen, as Lightroom's Auto does). It adds time at the end of a run; Cancel skips the rest. On hundreds of photos it is faster to leave it off and use Library > Previews > Build Standard-Sized Previews afterwards. |
What Crop edge does. Squarewell finds each side of the print, then moves the crop in by the Crop edge share of the photo's short side. The picture below shows the edges of five real prints, enlarged, with the background at the top of each strip and a line where each setting cuts. At 0.15% a thin sliver of straightedge, tape or background often stays in the crop; at 0.30%, the default, most are gone. Move the slider further left if a line still shows on your setup (Example 5 needs 0.40%), or toward 0 to keep every bit of the picture.

The options are remembered for next time. At the bottom of the dialog is the trial or license status, with Buy a license while on the free trial (see License and free trial).
A profile keeps every option of the dialog under a name: the kind of photo, the film format, print borders, crop edge, corners, the rotation flag, replacing crops, TIFF copies, previews and leaving unsure photos uncropped. Use one for each kind of work you do often.
AutoCrop-profiles.json, in the PictureOrg folder (Windows: %LOCALAPPDATA%\PictureOrg; Mac: ~/Library/Application Support/PictureOrg), so a profile saved in one shows in the other. The app has no options for replacing crops, TIFF copies or previews; when it saves over a profile, those stay as they were.126 film: many 126 (Instamatic) cameras lay a semi-transparent dark bar along each side of the picture and along its top or bottom. The picture shows faintly through them, but the crop is the full-strength picture between the bars. The bars are found even on rolls where the picture is about as dark as the bars, by the straight edge each bar makes down the whole frame. When a frame shows only one bar clearly, the other side is placed from the frame width the other frames of the selection showed.
The Film format list, under File content, is for negatives and slides (not album pages). Auto, the default, learns the frame size from the other frames of the strip, else uses a 35mm frame's 3:2. Or choose the format the film was shot in: 35mm full frame (3:2), 35mm half frame (4:3), XPan (65x24), 110, 126, 127 (square), 828, Disc, the medium formats 6x4.5, 6x6, 6x7, 6x8, 6x9, 6x12 and 6x17, 4x5, or Custom ratio (type the long side over the short, from 1 to 6: 1.50 is 3:2). Portrait or landscape is taken from the frame found. The format is saved in profiles.
Image format: with Slides, prints, magazines or documents chosen, the list is called Image format. It shows the formats slides came in, mounted: 35mm full and half frame, XPan, 110, 126, 127, 828, 6x4.5, 6x6 and 6x7. Below a divider it lists print sizes: Wallet print (2.5x3.5), 3x5, 3.5x3.5, 3.5x5, 4x4, 4x6, 5x5, 5x7, 8x10 and the 4x10, 4x11 and 4x12 panoramic prints, then paper and album pages: Letter paper (8.5x11), Legal paper (8.5x14), A5, A4 and A3 paper and the 12x12 album page, then instant prints: Polaroid SX-70 / 600 / i-Type, Polaroid peel-apart, Polaroid Spectra, Polaroid Go, Instax Mini, Instax Square and Instax Wide. Print sizes are not offered for negatives.
A dark object in the picture that runs right up to an edge, such as a chair or table leg, is as dark as the background, so the edge seems to be on the object's far side. When part of the side shows one straight edge further out and the rest scatter inside it, the straight edge is used, so the object is kept rather than the whole side being cropped in.
A print pushed into a metal corner piece or against a straightedge, or lying along one of a grid board's lines, can seem joined to the board. When the crop then comes out as the whole photo, or with one side running out to the edge of the photo, Squarewell looks for the print's own straight sides: each must run straight along the whole side, and together they must make one of the usual print sizes (4x6, 3.5x5, 5x7, 8x10, square and others). Where a side would cut off a wide strip, the print's other sides must stop at it, so a print that really runs off the photo is left as it is.
Slides shot in the same carrier sit in nearly the same place in every photo. After every photo has been measured, Squarewell looks for the place most photos agree on for each side. When a photo's side is off from that place, its other sides agree with the batch, and the photo has a clear edge near the agreed place, that edge is used instead. This fixes most slides where a glow or a dark stretch of picture threw an edge off.
A photo Squarewell isn't sure of (no clear edge on two or more sides) is never left out unless you tick Leave unsure photos uncropped. It is cropped and gets the yellow label and the keyword Check crop. When the photos just before and after it agree on a size and its own crop is within about 8% of it, it is drawn at their size. A print or slide whose edges were clear is never resized, so odd-size prints keep their own crop. A crop that keeps the whole picture because no edge was found anywhere, or that is only a narrow strip of the picture, also gets the yellow label and Check crop, so no photo passes without a look.
On a copy stand the camera, the board, the lighting and anything fixed to the stand (tape, a straightedge, a ruler) stay where they are while the prints change. When you crop three or more photos from the same setup together, Squarewell learns that background from them: the board with its grid lines, the tape and anything else that sits in the same place in most of the photos. A photo whose crop came out weak (it ran to the edge of the frame, took in a strip of tape, came out an irregular shape, or left a good part of the print outside it) is measured once more with the learned background painted out, and the new crop is used when it is clearly better.
If the camera was a hair off square to a slide, the picture's window is a slight trapezoid: one edge slopes while the opposite one doesn't. No straight crop can follow every edge. Squarewell chooses no black: the crop sits just inside every edge and trims a sliver where the window narrows. Fix individual photos by hand in the Crop tool if that sliver matters.
Some photos were cut to a circle, an oval or a ragged shape. Lightroom can only crop to a rectangle, so these get the rectangle around the whole photo: nothing of the photo is cut off, and the background shows in the corners. A round or oval photo is left straight; a ragged cut keeps the tilt of its best-fitting rectangle, on a copy stand's gray board too. Each one gets the keyword Picture Org > Irregular shape (left out of exports) and the green label, and the message at the end says how many there were, so you can filter on "Irregular shape" and check them. A photo counts as irregular when its outline fills less than 90% of the rectangle around it; ordinary prints and slides fill 95% or more.
Color labels: photos Squarewell wants you to look at get a color label, so they stand out in the grid:
A photo with more than one gets the first of these. A label goes with its keyword: when a later run (with Replace crops already made) finds the photo no longer needs a look and takes off "Check rotation" or "Irregular shape", the purple or green label goes too, so the labels and keywords always agree. A label on a photo without those keywords is yours and is never removed. The app does the same in sidecars it updates. A print kept whole with its deckled border gets the keyword Deckled edge (no label), so you can find those prints too, as do a flipped backwards scan (Scanned backwards (flipped)) and a black-and-white negative set to Black & White (Black & white negative). The keywords sit under Picture Org, the one keyword every Picture Org app files its keywords under, and are never included in exported files. Earlier versions filed them under Auto Crop: once you've run this version, you can delete that keyword in the Keyword List.
The reason on the photo: each photo that gets a color label, or isn't cropped, says why in plain words. For example:
In Lightroom the reason is in the Squarewell note field of the Metadata panel. To see it, choose the Squarewell view from the menu at the top of the Metadata panel. The first time, Lightroom asks to update the catalog for the plug-in's new field: click Update. The note is read-only, and you can search it with the Library filter. Each run sets the note, or clears an old one that no longer applies. Check rotation only replaces just the rotation sentence, and Turn the flagged photos takes the rotation sentence out of each photo it turns.
In the app the reason shows under each photo on the Check crops screen and in the large view, and the list of photos not cropped says why for each one.
photo.xmp.bak.| Message or problem | What to do |
|---|---|
| A crop looks wrong and you want to send it to The Picture Org | Create an error log. In Lightroom: select the photos that came out wrong, then Library > Plug-in Extras > Auto Crop: Create an error log. In the app: Create an error log… in the menu. A text file named "Squarewell error log" with the date is saved on your Desktop and shown in Explorer or Finder, and Squarewell offers to send it to The Picture Org: you see exactly what would be sent, with your home folder, user name, computer name, email addresses and license key already taken out, add a word about what looked wrong (and your email if you would like an answer), and click Send to The Picture Org. It holds the version, your computer's system, your options and the profile in use, each photo's crop as Lightroom (or the app) has it, including any Transform or lens correction that shifts a crop, the end of the log and the Check my setup results. File names are in it, the photos themselves are not, and nothing is sent unless you click Send. Small pictures of the problem photos: Lightroom asks first, with a tick box Include small pictures of the problem photos (the selected ones, up to 50), off unless you tick it; the app's error-log card has the same tick box (it takes the photos in the run that were labeled, not cropped, skipped or changed by hand, up to 50). Each picture is the photo made small (about 1000 pixels), with the background it found shaded blue, the outline it found in yellow, the crop it found in green, the crop the photo has now in red, and the reason line under it. There is one picture for each photo file: an album page is drawn once, with all its prints' crops on it, the way your last run cropped them. They go in one zip with the log (about 15 MB at most) on your Desktop. When you send the log, the pictures go only if you also tick Also send the small pictures (off unless you tick it), so you don't need to send the originals. They show your photos, so only tick it if you are happy to send them. |
| "Left n converted negative(s) as they were" | Those photos were already converted to positives (Negative Lab Pro or an inverted tone curve), and you chose Skip them (or they are album pages). Run Squarewell again and choose Crop them too to crop them; their colors stay as they are. |
| You want to check that everything Squarewell needs works on this computer, or support asks you to | Check my setup. In Lightroom: File > Plug-in Manager, select Squarewell, and click the button in the Check my setup section. In the app: Check my setup… in the menu. It checks Lightroom's version and the system, its Python, the image libraries, the camera raw reader, the readers for newer compressed DNGs (JPEG XL) and iPhone HEIC photos, the rotation check, saving in its log folder, the license or free trial (never the key itself), the last update check and the profile in use. It ends "Everything looks fine." or "Missing: …". Click Copy or Save on the Desktop to email it. It is also included in an error log. |
| "The bundled Python (python-win folder) is missing" | The folder was moved or partly copied. Unzip the plug-in again, all of it. |
| The Squarewell menu items appear twice, or the Plug-in Manager lists Squarewell (or Picture Org Auto Crop) twice | Squarewell is installed twice: once by the Setup program or Mac installer, once added by hand. In File > Plug-in Manager, select the entry whose path is not in Adobe/Lightroom/Modules and click Remove. You can then delete that old folder; your settings and license key are kept. |
| Nothing under Plug-in Extras after running the Setup program or Mac installer | Quit Lightroom Classic completely and start it again: it looks in its plug-in folder only when it starts. In File > Plug-in Manager, Squarewell should be listed and enabled; if it is listed but disabled, click Enable. |
| "needs a Mac with Apple silicon" (Mac) | Squarewell runs only on a Mac with Apple silicon (M1 or later). This Mac has an Intel processor. The Windows version runs on any 64-bit Windows 10 or 11 PC. |
| macOS says the plug-in's Python can't be opened (plug-in installed by hand, Apple silicon) | Go to System Settings > Privacy & Security and click Open Anyway, then run Squarewell again. |
| A photo is listed under "Not cropped" | Usually no clear item against the background (a black background, a white background or a copy stand). The reason is in the message and in the photo's Squarewell note (see Labels, keywords and notes). Details are in autocrop-log.txt in the temp folder (Windows: C:\Users\<you>\AppData\Local\Temp, or type %TEMP% in File Explorer's address bar; Mac: the folder echo $TMPDIR shows in Terminal). The message gives the full path at its end. |
| "Lightroom changed these values" | Lightroom adjusted a crop as it applied it. Create an error log (first row) so The Picture Org can see what changed; the message is in it. |
| "The file name or folder has a tab or line break in it" | Rename the file or folder without the tab or line break (it can come from a copied name), then run Squarewell on it again. |
| Photos with crops were skipped | Tick Replace crops already made. |
| A negative, slide or print's note says "Format: the frame found is …, so it was cropped as found" | The frame doesn't fit the film format chosen (see Film format and Image format). Check the crop. If the whole roll is another format, choose that one, or Auto, and run again with Replace crops already made. |
| "Nothing was saved: the profiles file could not be read" | The file AutoCrop-profiles.json in the PictureOrg folder is damaged. The starter profiles are shown meanwhile. Move that file somewhere else (it is never written over), and the list starts again. |
| "(changed)" shows beside the profile | An option differs from the profile. Click Save to keep it in the profile, or choose the profile again to go back to its settings. |
| Remove is grayed out in the Plug-in Manager | Normal for a plug-in installed by the Setup program or Mac installer: Lightroom loads it from its own plug-in folder and only lets you Disable it there. To remove it, use Uninstall Squarewell (see Install), or delete the PictureOrgAutoCrop.lrplugin folder from Lightroom's Modules folder with Lightroom closed. |
| Windows Setup says "Error opening file for writing" | The Squarewell app was still running: it keeps going for a couple of minutes after its window is closed. Setup closes it for you; if the message still shows, wait a moment and click Retry, or end pythonw.exe in Task Manager first. |
| A crop cuts off detail right at a slide mount's edge | Run those photos again with Crop edge at 0, or a little to the right of it (and Replace crops already made). |
| A crop shows a thin line of background | Move Crop edge a little to the left (Trim in 0.5%), or adjust that photo by hand. |
| A crop cuts too far in | Usually a photo whose picture runs dark right to the edge. Adjust by hand, and create an error log for it (first row) so it can be used as a test case. |
| A photo is flagged for rotation but is the right way up | Remove the keyword (the purple label stays; remove it with Photo > Set Color Label > None if you don't want it). Send the photo to The Picture Org as a test case. |
| One photo's crop is shifted compared with others from the same run | That photo probably had earlier edits (Transform, Upright, Lens Corrections), which Lightroom applies before the crop. In Develop, click Reset, then run again with Replace crops already made. |
| A negative's crop includes rebate or cuts into the picture | Select the whole strip or roll and run again with Replace crops already made: the other frames fill in edges that can't be seen. Send the frame to The Picture Org as a test case. |
| A sideways photo is not flagged | The guess misses some (see Find and turn sideways photos). Check the last line of autocrop-log.txt: "Lightroom rotation given for 0 of N photos" means your Lightroom version doesn't report its rotation, so the file's own was used; tell The Picture Org. |
| Turn the flagged photos stops with "did not turn as expected" | Use Edit > Undo, make sure you have the current version (see Updates), and run it again. |
What is in autocrop-log.txt |
For each run: a line with the date, version, system and options, then each photo's result (crop, angle, rotation flag, note), then what Lightroom stored for each photo. Errors are recorded too. The error log (first row) includes the end of it, so you don't need to find it yourself. Once it passes 2 MB it is renamed autocrop-log.old.txt (replacing the older one) and a new one starts. |
| "The trial has ended. Enter a license key…" | Buy a license, or enter your key (see License and free trial). |
| "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. |
| "That key is for an older version" | The key is for an earlier major version; an upgrade key is needed for this one. |
| The app: nothing opens, or the page says "Please open Squarewell from its shortcut" | Start it from its shortcut (Windows Start menu, Mac Applications > ThePictureOrg); it opens the page with its own address. If a browser tab from an earlier session is left open, close it. If nothing opens at all, look at the end of AutoCrop-app-log.txt in the PictureOrg folder (Windows: %LOCALAPPDATA%\PictureOrg; Mac: ~/Library/Application Support/PictureOrg). |
| 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. |
| The app on a Mac: "Squarewell could not start" | Open Install Squarewell from the download again. |
| Lightroom doesn't show the crop 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 DNG, JPEG and TIFF use new pictures or the plug-in (see Check every crop before saving, with the app). |
Every action in Squarewell 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 | Find crops | go |
| X | Cancel | stop |
| Shift+W | Save | write |
| N | Crop 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 |
| S | Slides, prints | slides |
| M | Film negatives | negatives |
| Y | Album pages | albums |
| B | Before and after | before-after |
| [ | Turn the crop left 0.1° | turn-left |
| ] | Turn the crop right 0.1° | turn-right |
| Backspace | Undo my changes to this crop | reset |
| 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 Squarewell's window is in front.
For buttons that work while Squarewell is behind other windows, add The Picture Org -well tools for Stream Deck, which comes with Squarewell: press ? in Squarewell 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: Squarewell --do <name> (on Windows, Squarewell.exe in Squarewell's folder), using the names in the tables. It only reaches the copy of Squarewell 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 Squarewell app's own window. In Lightroom, click Keyboard shortcuts (in the Squarewell window, next to User Guide, or in the Plug-in Manager) to see Squarewell's commands and the ways to run them without the menu, and to add the Stream Deck buttons. The Squarewell plug-in listens for Squarewell --do lr:<name> (and the Stream Deck button) instead, on this computer only:
| Library > Plug-in Extras | Name |
|---|---|
| Auto Crop & Straighten... | lr:crop |
| Auto Crop now: slides and prints | lr:slides |
| Auto Crop now: film negatives | lr:negatives |
| Auto Crop now: album pages | lr:albums |
| Check rotation only | lr:rotation |
| Set white balance only (negatives) | lr:whitebalance |
| Turn the flagged photos | lr:turn-flagged |
Your own keys in Lightroom. In the Keyboard shortcuts window, choose a key for any of Squarewell'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-Squarewell-Setup-<version>.exe)
Mac: the Install Squarewell app (ThePictureOrg-Squarewell-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 Squarewell offers an update (see Updates). Your settings and license key are kept. To remove Squarewell, use Uninstall Squarewell in the Start menu on Windows, or the Uninstall Squarewell app in the Mac download.
Installing the plug-in by hand: on Windows, right-click ThePictureOrg-Squarewell-Win-<version>.zip, choose Properties, tick Unblock, and unzip it. On a Mac, right-click Install Squarewell, choose Show Package Contents and open Contents > Resources. Move the PictureOrgAutoCrop.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\PictureOrgAutoCrop.lrplugin on Windows, ~/Library/Application Support/Adobe/Lightroom/Modules/PictureOrgAutoCrop.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/AutoCrop-install.log.
%LOCALAPPDATA%\PictureOrg on Windows, ~/Library/Application Support/PictureOrg on a Mac.Updates within the major version are complimentary.
Coming from an earlier version? Some menu items and options have new names. A keyboard shortcut made for an old menu title needs the new one:
Earlier versions: see CHANGELOG.txt.
| File or folder | Purpose |
|---|---|
Info.lua |
Tells Lightroom about the plug-in: its name, version and menu items. |
AutoCropMenu.lua |
The menu command: the options dialog, running the helper, applying crops and keywords, the message at the end. |
PluginInfoProvider.lua, logo.png |
The panel shown in File > Plug-in Manager: the website and User Guide buttons, the License section (trial or license status, Buy a license, the box for your key; with a license in place, only Remove license from this computer), and Check my setup. |
Update.lua, Init.lua |
Checking for a newer version (see Updates): once a day in the background, and the Updates section of the Plug-in Manager. |
License.lua |
The free trial and license key check before each run, and finding the Python the helper runs with. |
Profiles.lua, helper\profiles.py |
The named settings profiles (see Profiles), for the plug-in and for the app. |
helper\autocrop.py |
The helper program that looks at each photo and works out the crop. Lightroom runs it in the background. |
helper\autocrop_detect.py |
Finding the item, its edges, the angle and print borders; the batch check. |
helper\orient.py |
The orientation check (faces, scene, sky, horizon). |
helper\filmformat.py |
The film formats for negatives and slides (see Film format and Image format). |
helper\po_license.py |
Checks the license key and counts the free trial, on this computer (nothing is sent anywhere). Shared with the Spoolwell Video Finishing Toolbox. |
helper\app.py, helper\app_render.py, helper\app_ui.html, app-icon.ico, app-icon.icns |
The app: a small program that runs on this computer only and shows its page in your web browser; cutting out the crops and writing the new pictures and sidecars; the page itself; the app's icons. |
helper\update_apply.py |
Installs an update from inside Lightroom (Install now): checks the download and swaps the new files in, putting everything back if anything fails. |
helper\data |
Face-detection data from OpenCV and a small face-detection model from MediaPipe, used by the orientation check. |
python-win |
Windows download: Python and its image libraries for Windows. Nothing to install. |
python-mac |
Mac download: Python and its image libraries for Apple silicon Macs. Nothing to install. |
Uninstall Auto Crop.exe |
Windows, only when installed with the Setup program: removes the plug-in and the app (also in the Start menu). It is in the app's folder. |
third-party-source |
Source code of rawpy and LibRaw, and of libheif and libde265, which read HEIC photos: their licenses ask for it to be included. |
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. The app is a copy of the same folder, installed separately.
Where things go: on Windows the app is in %LOCALAPPDATA%\Programs\ThePictureOrg\Squarewell, with a Squarewell folder in the Start menu holding the Squarewell app, Squarewell User Guide, Squarewell Cheat Sheet and Uninstall Squarewell. On a Mac the app is in Applications > ThePictureOrg (or a ThePictureOrg folder in the Applications folder in your home folder, if the main one can't be written). The plug-in goes into Lightroom's own plug-in folder (see Install). Your settings, profiles, license key and the app's logs (AutoCrop-app-log.txt and autocrop-log.txt) are in the PictureOrg folder: %LOCALAPPDATA%\PictureOrg on Windows, ~/Library/Application Support/PictureOrg on a Mac. The installers keep a log for support in ~/Library/Logs/PictureOrg/AutoCrop-install.log on a Mac.
© 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. Squarewell includes Python (PSF License), NumPy (BSD), OpenCV (Apache 2.0), rawpy (MIT), LibRaw (GNU LGPL 2.1), ONNX Runtime (MIT), PyYAML (MIT), RapidOCR and the PaddleOCR text models (Apache 2.0), and word lists made from wordfreq by Robyn Speer (CC BY-SA 4.0); see NOTICE.txt. Adobe and Lightroom are trademarks of Adobe Inc.; other names are trademarks of their owners.
This is the User Guide that comes with Squarewell, kept up to date with each release. Questions: info@thepictureorg.com · Squarewell home page · All the -well tools