Basic Usage Guide¶
This guide covers the fundamental workflow for using Lightroom AI Tagger.
Workflow Overview¶
- Prepare your images in Lightroom Classic
- Close Lightroom Classic
- Run the tagger
- Review and import the keywords in Lightroom
Step-by-Step Instructions¶
1. Prepare Your Images¶
- Ensure your images are properly imported into Lightroom Classic
- Organize images into collections if desired
- Make sure all images have XMP sidecar files enabled:
- Go to Catalog Settings > Metadata
- Check "Automatically write changes into XMP"
2. Run the Tagger¶
Basic command for processing a Lightroom catalog:
Or process a folder of images:
3. Review Results¶
The tool will: - Process each image through the AI model - Generate relevant keywords - Update XMP sidecar files - Create a JSON report (optional)
Example output:
Processing image 1/50: DSC_0001.NEF
Found 15 keywords
Added new keywords: landscape, mountain, sunset, nature
Total keywords: 15
Processing image 2/50: DSC_0002.NEF
Found 12 keywords
Added new keywords: portrait, indoor, lighting
Total keywords: 12
4. Import Keywords in Lightroom¶
- Reopen Lightroom Classic
- Select the processed images
- From the menu: Metadata > Read Metadata from Files
- Review the imported keywords in the Keywording panel
Tips for Best Results¶
- Use the
--thresholdoption to adjust keyword sensitivity - Start with
--dry-runto preview changes - Use
--max-keywordsto limit the number of keywords per image - Keep Lightroom closed while processing to avoid conflicts