“The engine file is missing” · Windows

MetaMagic Faces does its work with a small program that comes with it: MetaMagicFacesEngine.exe, in the folder engine of the plug-in. It is new and not known to every antivirus yet, so Windows Defender or another antivirus sometimes removes it.

  1. Open Windows Security › Virus & threat protection › Protection history.
  2. Find the entry for MetaMagicFacesEngine.exe, open it and choose Restore (or Allow on device).
  3. So that it does not happen again: Virus & threat protection settings › Exclusions › Add an exclusion › Folder, and choose the plug-in folder. Lightroom shows where it is: File › Plug-in Manager, select MetaMagic Faces, “Show in Explorer”.
  4. With another antivirus program the steps are similar: look for its quarantine and its exclusions.
  5. Restart Lightroom and open MetaMagic Faces again.

The file is not in the quarantine? Then the zip was probably not extracted completely: see Install it again.

“Permission denied” · “The engine may not write in the folder” · Windows

MetaMagic Faces keeps the people you taught, your licence and its log in Documents › MetaMagic Faces. Windows Controlled folder access (part of the ransomware protection) or an antivirus can stop unknown programs from writing in Documents. You see this message, often when you enter your Customer Code.

  1. Open Windows Security › Virus & threat protection.
  2. Under Ransomware protection click Manage ransomware protection.
  3. If Controlled folder access is on, click Allow an app through Controlled folder access › Add an allowed app › Browse all apps.
  4. Choose MetaMagicFacesEngine.exe in the folder engine of the plug-in (File › Plug-in Manager › “Show in Explorer” shows where it is).
  5. Restart Lightroom and try again.

“The recognition engine did not answer”

  1. Restart Lightroom and open MetaMagic Faces again.
  2. Check that the plug-in folder is really on your computer. In a OneDrive folder, right-click it and choose Always keep on this device, or move the plug-in to a normal folder (see Install it again).
  3. Check the antivirus as described above: it can also stop the engine while it runs.
  4. Make sure there is some free space on drive C: (the engine unpacks itself in the temporary folder when it starts).
  5. Still the same? Send a report – it contains the exact error.

Install it again

  1. Download the latest version from the MetaMagic Faces page.
  2. Right-click the zip › Extract all. Do not open the plug-in from inside the zip.
  3. Put the folder MetaMagicFaces.lrplugin in a normal folder on your computer, for example C:\Users\<you>\Lightroom Plugins, not in a folder that is only online.
  4. In Lightroom: File › Plug-in Manager › Add › choose that folder. If an older copy is listed, remove it first. Your people and reference faces are kept.

MetaMagic Faces does not start on a Mac

  • Wrong package: there is one for Macs with Apple Silicon (M1, M2, M3, M4…) and one for Intel. Apple menu › About This Mac tells you which one you have. Download the right one and replace the plug-in folder.
  • “cannot be opened”: open System Settings › Privacy & Security, scroll down and click Open Anyway next to MetaMagicFacesEngine. Then open MetaMagic Faces again.

The Customer Code does not work

  • No connection to the MetaMagic server: check the internet connection, a VPN or a firewall that blocks Lightroom.
  • Code not accepted: copy it again from the e-mail you received after registering (it starts with cus_), without spaces.
  • Too many computers: one licence works on up to 3 computers. Write to us and we move it to the new one.
  • “The recognition engine could not start” when you enter the code: the code is fine – the engine is blocked. See Permission denied and Engine missing.

Still not working? Send us a report

When MetaMagic Faces cannot start, it opens a window with Send report. You can also send one at any time: in Lightroom Library › Plug-in Extras › MetaMagic Faces – report a problem…, or the flag button at the top of the MetaMagic Faces page.

The report contains what we need to find the cause: versions, system, the files of the engine folder and the error log. No photos and no names of people. Add your e-mail so we can answer you.

The log is also on your computer: Documents › MetaMagic Faces › faces-log.txt. You can send it to contact@metamagicplugin.com.