Adobe Lightroom Classic

Zero File Mutation Post-Production Sync

Professional photographers rely on Adobe Lightroom Classic, Capture One Pro, and Photo Mechanic for editing and client delivery. Proprietary cloud tools that force users into a walled garden disrupt established post-production workflows.

BestShots.AI is built around the open Extensible Metadata Platform (XMP) sidecar standard, ensuring your AI decisions, ratings, and tags synchronize directly into your favorite desktop software without touching a single byte of your master files.

---

The Sidecar Philosophy & Zero File Mutation Guarantee

An XMP sidecar is a lightweight, human-readable XML file that resides alongside your camera RAW image, sharing the exact same base filename:

The Zero RAW Mutation Guarantee

BestShots categorically promises:

• Zero Byte Changes: We never write directly into the header, payload, or maker-notes of original camera RAW files (.ARW, .CR3, .NEF, .RAF, .DNG).
• Bit-for-Bit Integrity: Your master files remain cryptographically identical before and after using BestShots.
• Universal Portability: If you decide to stop using BestShots, your exported .xmp sidecars remain completely valid and readable forever by any software supporting the Adobe XMP specification.

---

Metadata Namespace Mapping

BestShots maps AI curation scores, photographer decisions, and subject tags to standard XMP namespaces:

<x:xmpmeta xmlns:x="adobe:ns:meta/">
  <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
    <rdf:Description rdf:about=""
      xmlns:xmp="http://ns.adobe.com/xap/1.0/"
      xmlns:dc="http://purl.org/dc/elements/1.1/"
      xmlns:focus="http://ns.bestshots.ai/focus/1.0/">
      
      <!-- 1. Star Rating (1-5) -->
      <xmp:Rating>5</xmp:Rating>
      
      <!-- 2. Color Label -->
      <xmp:Label>Purple</xmp:Label>
      
      <!-- 3. Standard Dublin Core Keywords -->
      <dc:subject>
        <rdf:Bag>
          <rdf:li>ai-keep</rdf:li>
          <rdf:li>stack-hero</rdf:li>
          <rdf:li>sharp-focus</rdf:li>
          <rdf:li>open-eyes</rdf:li>
          <rdf:li>person:Sarah</rdf:li>
        </rdf:Bag>
      </dc:subject>
      
      <!-- 4. Dublin Core Rationale Summary -->
      <dc:description>
        <rdf:Alt>
          <rdf:li xml:lang="x-default">Primary subject in sharp focus (0.94), eyes wide open, joyful expression. Designated hero frame in 4-shot burst.</rdf:li>
        </rdf:Alt>
      </dc:description>
      
      <!-- 5. BestShots Deep Diagnostic Telemetry -->
      <focus:sharpnessScore>0.942</focus:sharpnessScore>
      <focus:eyeBlinkProbability>0.012</focus:eyeBlinkProbability>
      <focus:burstClusterId>burst_7f20e4</focus:burstClusterId>
      <focus:isStackPrimary>true</focus:isStackPrimary>
      
    </rdf:Description>
  </rdf:RDF>
</x:xmpmeta>

---

Step-by-Step Lightroom Classic Sync Workflow

Follow this walkthrough to export and import BestShots curation decisions into your Adobe Lightroom Classic catalog:

Step 1: Export Workflow Bundle from BestShots

1. In your project workspace, click Export in the top toolbar (or press E).
2. Select destination: XMP Sidecars & Workflow Bundle (.zip).
3. In the Settings step:
   • Photo & Sidecar Naming Format: Keep the default Keep Original Camera Filenames (e.g. 080A0386 · Recommended). This guarantees that exported .xmp sidecars share the identical base name of your camera RAW files (e.g. _DSC1200.CR3 paired with _DSC1200.xmp).
   • Metadata & Information: Ensure Include 1-Click Desktop Organizer scripts is checked.
   • (Optional) Check Include 2048px high-resolution WebP previews if you need offline client proofs or quick web viewing.
4. Click Start Export and download the ZIP archive.

Step 2: Copy Sidecars into your RAW Directory

Extract the .zip archive. Copy the .xmp files directly into the folder where your original RAW files reside on your local hard drive or external SSD. Verify that the filenames match exactly (e.g. 080A0386.CR3 alongside 080A0386.xmp).

Step 3: Read Metadata in Lightroom Classic

1. Launch Adobe Lightroom Classic and open your catalog.
2. Switch to Library Module Grid View by pressing G.
3. Select all photos in the folder (Ctrl/⌘ + A).
4. In the top application menu, select Metadata > Read Metadata from Files (or press Cmd + Option + S on macOS / Ctrl + Alt + S on Windows).
5. When the confirmation prompt appears, click Read.

Step 4: Filter by Keepers & Heroes

Immediately upon reading metadata:

• All Keepers will display their 5-star ratings.
• The Filter Bar (\) allows you to isolate Rating >= 5 to reveal your curated set.
• All detected tags (ai-keep, stack-hero, person:Bride) appear in the Keywording panel for instant filtering.

---

1-Click Desktop Organizer (Zero Software Required)

If you want to isolate your keeper RAW files on your local drive without opening Lightroom or any editing software, use the included desktop organizer scripts:

1. Extract the exported ZIP bundle.
2. Copy organize_keepers.bat (Windows) or organize_keepers.command (macOS) into the folder containing your camera RAW files.
3. Double-click the script:
   • On Windows: Run organize_keepers.bat.
   • On macOS: Double-click organize_keepers.command (pre-configured with executable permissions).
4. Result: The script reads the list of approved keeper photos, creates a new bestshots_keepers directory, and copies all keeper RAW files into it in under a second. Rejected photos remain untouched in the source folder.

---

Interactive Visual Quickstart Guide (README.html)

Every exported workflow bundle contains a self-contained, responsive README.html file. Double-clicking this file opens an offline visual dashboard in your browser featuring:

• Shoot Overview: Total photo count, keepers count, rejection count, and keeper percentage.
• Camera & Lens Summary: Gear inventory of camera bodies and lenses used during the shoot.
• Tool Walkthroughs: Tabbed, step-by-step instructions for Adobe Lightroom Classic, Capture One Pro, and Desktop Organizer scripts.

---

Free Software Verification (No Paid Lightroom License Needed)

If you do not have a paid Adobe Lightroom Classic subscription, you can fully test and verify BestShots XMP sidecars using these free alternatives:

Method 1: Adobe Bridge (100% Free Forever · Recommended)

Adobe Bridge is Adobe's official digital asset manager. It uses the exact same Adobe Camera Raw (ACR) metadata engine as Lightroom Classic, and it is completely free with any free Adobe ID (no Creative Cloud subscription or payment information required):

1. Download and install Adobe Bridge via the free Adobe Creative Cloud desktop application.
2. Copy your exported .xmp sidecars into the folder with your camera RAW files.
3. Open Adobe Bridge and browse to that folder.
4. Verification: Bridge immediately reads the .xmp sidecars. Star ratings (1 to 5 stars) and color labels ("Winner" / "Select") appear directly below every thumbnail. Filter by rating on the left panel to isolate keepers.

Method 2: Darktable (Free & Open Source RAW Developer)

Darktable is an open-source photography workflow application available on Windows, macOS, and Linux:

1. Download and install Darktable.
2. On first launch, Darktable asks how to handle XMP files: choose after edit (Recommended). This ensures Darktable reads BestShots sidecars upon import without immediately overwriting or altering them.
3. In the top-left import panel, click folder and select your photo directory.
4. Verification: In Lighttable grid view, Darktable displays the imported photos with their AI star ratings.

---

Compatibility with Other Software

• Capture One Pro: Select images, right-click, and choose Load Metadata. Alternatively, enable Auto Sync Sidecar XMP in Preferences > Image > Metadata to have Capture One automatically synchronize sidecars when added.
• Photo Mechanic: Photo Mechanic automatically reads .xmp sidecars in real time. Color classes, ratings, and tags update immediately upon folder refresh.
• Apple macOS Finder & QuickLook: Standard macOS QuickLook previews high-resolution WebP proxies when bundled.