Install workflow

Install KeywordLens and tag your first Lightroom batch.

A practical path from release ZIP to backend setup, Lightroom registration, optional offline packs, and your first metadata write.

Safe default

Existing Lightroom keywords are preserved by default. Original image pixels are not changed by metadata enrichment.

Download and extract

Grab the latest keywordlens-v*.zip from the downloads page and unzip it to a stable, permanent folder on your machine.

Run the setup script

From inside keywordlens/, run bash setup/setup.sh on macOS or powershell -ExecutionPolicy Bypass -File setup\setup.ps1 on Windows. Setup checks Python 3.12+, uses Homebrew or winget when available, guides you when they are missing, creates server/venv, installs backend dependencies, and verifies the backend health check.

Add the plugin in Lightroom Classic

Open File -> Plug-in Manager -> Add. Browse into keywordlens/plugin/, highlight keywordlens.lrdevplugin, and choose that folder.

Configure your AI provider

Use the setup script's provider prompts, the first-run setup wizard, or Plug-in Manager settings to configure provider, model, and API key for your workflow.

Optional: install offline packs

In Plug-in Manager, use Install Offline Packs From Catalog. The hosted catalog URL is shown below.

https://keywordlens.ddbworks.com/packs/catalog.json

Tag your first photo

Select a photo or batch, then use Library -> Plug-in Extras -> KeywordLens -> Analyze Selected Photos.

Need more detail?

The full manual covers every menu item, setting, and troubleshooting path.

Use the website for artifacts and the full operational guide.

Open user manual