Installation

Install Framemodu with the official macOS or Windows installer, confirm it in Lightroom Classic Plug-in Manager, then run one test export before using it on a full batch.

Download the right installer

Open the Download page on the same computer that runs Lightroom Classic. Use Auto download for this device, or choose macOS Apple Silicon, macOS Intel, or Windows x64 manually if you are preparing an installer for another machine.

  • Download the .pkg file for macOS or the .msi file for Windows.
  • Do not download a development .lrdevplugin folder for normal use.
  • The official installer includes the plug-in, renderer runtime, and native image-processing dependencies.

Run the installer

Quit Lightroom Classic before installing. On macOS, open the downloaded .pkg and follow the installer steps. On Windows, open the downloaded .msi and complete the setup for the current Windows user.

  • macOS may ask for your Mac account password to complete installation.
  • The Windows installer is not yet signed with a Windows publisher certificate, so Windows may show an unknown-publisher or SmartScreen prompt.
  • Only continue through a security prompt when the installer was downloaded from framemodu.com.

Open Lightroom Classic

After installation, start Lightroom Classic and choose File > Plug-in Manager. Framemodu should appear automatically in the installed plug-ins list because the installer places it in the Lightroom Classic Modules location.

  • Manual Add is only a recovery step if Lightroom does not detect the installed package.
  • If Lightroom was open during installation, restart Lightroom Classic before checking the list.
  • If Lightroom asks to update the catalog or restart, finish that host-app step first, then return to Plug-in Manager.
Real Lightroom Classic Plug-in Manager view with Framemodu selected in the installed plug-ins list.
Real Lightroom Classic Plug-in Manager view with Framemodu selected in the installed plug-ins list.

Confirm the plug-in status

After Lightroom loads the plug-in, select Framemodu in the left list. The status panel should show Ready, and the language should match the Lightroom UI language currently in use.

  • If the status is disabled, click Enable in Plug-in Manager.
  • If the plug-in is listed but not ready, rerun the current installer and restart Lightroom Classic.
  • If localization looks wrong, restart Lightroom Classic after changing the app language.
The status panel should show Framemodu as ready before you run an export.
The status panel should show Framemodu as ready before you run an export.

Check renderer and dependencies

Framemodu renders the final framed file locally after Lightroom finishes its own export. In Plug-in Manager, the Renderer, Runtime, and Dependencies rows should show that the bundled renderer is ready.

  • Customers do not need to install Node.js, npm, Homebrew, Sharp, or command-line developer tools.
  • If a renderer row is missing, reinstall from a fresh platform installer instead of moving files by hand.
  • The renderer runs on local exported files; normal export rendering does not upload your photos.
Renderer and Dependencies are shown as installed in the plug-in status area.
Renderer and Dependencies are shown as installed in the plug-in status area.

Export one test photo

Before processing a full client set or portfolio batch, open File > Export, confirm that Framemodu appears in Post-Process Actions, pick a simple template, and export one JPEG to a test folder.

  • Use one selected photo for the first test.
  • Trial Mode can export the default Info Strip template before purchase.
  • Keep Lightroom's native File Settings and Image Sizing choices conservative until the output looks correct.
  • After the test file is correct, save the export settings as a preset for repeated work.
The Export dialog should show the Framemodu panel before you run a full batch.
The Export dialog should show the Framemodu panel before you run a full batch.

If Framemodu does not appear

If the export filter is missing from Post-Process Actions, return to Plug-in Manager first. The most common causes are Lightroom still running during installation, installing for a different operating-system user, duplicate older entries, or moving the installed framemodu.lrplugin folder after setup.

  • Restart Lightroom Classic once after installation.
  • Remove duplicate or stale Framemodu entries before rerunning the current installer.
  • Keep the installed plug-in folder intact so Lightroom can keep reading the renderer runtime and dependencies.

Before a full production batch

Treat the first export as a validation file. Open the rendered JPEG, check frame alignment, output ratio, metadata text, logo mode, and destination folder before saving a preset or exporting a full client gallery. This keeps Lightroom's native export choices and Framemodu's post-process finish aligned.

  • Use a small test set when changing templates or ratios.
  • Compare one plain Lightroom export with one Framemodu export when diagnosing output-size questions.
  • Keep the successful settings as a named Lightroom export preset for repeatable delivery.

Related topics

  • install Lightroom Classic plugin
  • Framemodu installation
  • Lightroom Plug-in Manager
  • Lightroom plugin renderer status