# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.calibratedsoftware.com/calibrated-quicklook-plugin-macos/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.