> For the complete documentation index, see [llms.txt](https://docs.calibratedsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.calibratedsoftware.com/calibrated-quicklook-plugin-macos/troubleshooting.md).

# Troubleshooting

### Supported MXF files are not showing video previews

macOS loads Apple’s native MXF QuickLook provider at startup. To allow Calibrated QuickLook to handle video previews for supported MXF files, **Finder must be restarted after each system startup**.

Force-quit and relaunch Finder, then preview the MXF file again using QuickLook.

### Supported Files Aren’t Creating Thumbnails

1. **Verify Tin Man is installed in the /Applications folder**\
   (the plugin is inside the Calibrated Tin Man.app).
2. Allow **5–10 minutes** after installation for initial thumbnails. Very large media libraries may take longer.
3. Confirm the file format is supported (see Support Formats).
4. Verify drive is writeable by the System and is formatted as APFS 
5. **Force QuickLook to reload the plugin and restart Finder:**

   ```bash
   qlmanage -r
   killall Finder
   ```
6. **Clear Thumbnail Cache (this will delete all saved thumbnails and force Finder to remake Thumbnails)** 

   ```bash
   qlmanage -r cache
   ```

***

### **How to Disable the Calibrated QuickLook Plugin**

If you prefer not to use QuickLook integration:

1. Open **System Settings**.
2. Navigate to **General → Login & Extensions**.
3. In the *QuickLook* section, click the **ⓘ (info icon)** next to **Calibrated Tin Man.app**.
4. Toggle either Preview and/or Thumbnail *off* for the Tin Man extension.