SPA 11 - What's new!!!
TUTORIALS COMING SOON
We are currently working on completely redoing the SPA training. However, we didn’t want to wait to release SPA 11 because your current SPA 10 workflow will still work EXACTLY the same in SPA 11. So you can update the software and then just implement new features as needed, but don’t need to right away.
Some of the new SPA 11 features are self explanatory and can easily be implemented into your workflow. Other feature may require a little training…. so for those features stay tuned for documentation and training.
πΈ Lightroom Crop Import Plugin
This Lightroom Classic plugin reads crop coordinates from a CSV/TSV (or JSON) file and applies them directly to matching images in your Lightroom catalog.
It supports .jpg / .JPG case-insensitive filename matching, manual input rotation, and optional Lightroom-library rotation adjustment.
π Installation
- Download or Clone Plugin: Place the plugin folder somewhere permanent (e.g.,
~/Documents/Lightroom Plugins/CropImporter.lrplugin). - Open Lightroom Classic: Go to File β Plug-in Manager. Click Add, browse to the folder containing
Info.luaandCommon.lua, and select it. Click Done. - Set Preferences (First Run): From the Library module, go to File β Plug-in Extras and choose:
- Set Inbox Folder β folder where crop data files will be dropped.
- Set Base Folder β (optional, not needed for filename-only match).
- Set Input Rotation β choose 0, 90, 180, or 270 to match your imageβs base orientation.
π Folder Structure
The plugin expects: /Users/<YourName>/crops_inbox/ β Folder containing your crop data files
Supported formats: TSV (.txt, .tsv), CSV (.csv), JSON (.json)
Example TSV file:
ImageName CropL CropT CropR CropB Angle KIT3_1442_Yamilet-109355-Cabrera__0131.JPG 0.25448 0.14894 0.70369 0.52360 0
π Usage
- Prepare crop data file from your external system (ensure normalized crop coordinates in 0..1 range).
- Copy the file into your Inbox Folder.
- In Lightroom: Go to File β Plug-in Extras β Import Crops Now.
- Check the log in Lightroom and/or popup dialogs to confirm applied crops.
π Rotation Handling
- Input Rotation β set via Set Input Rotation menu. This rotates all incoming crops before applying.
- Lightroom Library Rotation β disabled by default in
Common.lua(adjustForLibraryRotation=false). Enable if you want the plugin to also consider Lightroomβs stored image rotation.
βοΈ Preferences Saved Between Runs
All preferences (Inbox Folder, Base Folder, Delete After Import, Input Rotation) are stored in Lightroomβs plugin preferences file and loaded automatically on next run.
π§Ή Optional Cleanup
If Delete After Import is enabled, the plugin will automatically delete processed crop data files from your inbox folder after successful application.
π Known Limitations
- Crops must be normalized (0.0 β 1.0), not pixel-based.
- No batch rotation detection β you must set rotation manually or enable Lightroom metadata rotation.
- If an image is missing from your Lightroom catalog, it will be skipped.
π Troubleshooting
- Nothing happens? Make sure filenames in the crop data match exactly (case-insensitive) with the filenames in Lightroom.
- Wrong crop applied? Verify your coordinates are normalized relative to the correct image orientation. Double-check Input Rotation setting.
π License
Private use only β not distributed via Adobe Exchange.
