> 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-windows/troubleshooting.md).

# Troubleshooting

### The preview says "Open Tin Man to finish setting up previews." <a href="#user-content-the-preview-says-open-tin-man-to-finish-setting-up-previews" id="user-content-the-preview-says-open-tin-man-to-finish-setting-up-previews"></a>

Calibrated QuickLook uses GPU components that Tin Man prepares when it opens. Open Tin Man once after installing, and again after every update, then select the clip again. Thumbnails wait for this step too.

### The preview says "No preview available." <a href="#user-content-the-preview-says-no-preview-available" id="user-content-the-preview-says-no-preview-available"></a>

1. Check that **Previews** is turned on for that format in **Tin Man → Preferences → Calibrated QuickLook**.
2. Previews play only in Windows Explorer and the apps listed under Preview Playback Features.

### Downloaded files don't show a preview <a href="#user-content-downloaded-files-dont-show-a-preview" id="user-content-downloaded-files-dont-show-a-preview"></a>

Windows Explorer doesn't preview files downloaded from the internet; it shows a warning that the file could harm your computer instead. This is a Windows security feature. If you trust the file, unblock it: right-click the file, choose **Properties**, check **Unblock** and click **OK**.

To unblock a whole folder of downloaded clips, run this in PowerShell (change the folder path):

```
Get-ChildItem "C:\Clips" -Recurse -File | Unblock-File
```

Files copied from camera cards and drives aren't affected.

### Thumbnails don't change after turning a format on or off <a href="#user-content-thumbnails-dont-change-after-turning-a-format-on-or-off" id="user-content-thumbnails-dont-change-after-turning-a-format-on-or-off"></a>

Changes apply right away, but Windows keeps the thumbnails it has already made. Clear the thumbnail cache, and Windows remakes thumbnails as you browse:

1. Open **Disk Cleanup** (search for it in the Start menu) and choose your system drive (usually C:).
2. Check **Thumbnails** (you can uncheck everything else) and click **OK**.

### Supported Files Aren't Creating Thumbnails <a href="#user-content-supported-files-arent-creating-thumbnails" id="user-content-supported-files-arent-creating-thumbnails"></a>

1. **Open Tin Man at least once** since installing or updating.
2. Confirm **Thumbnails** is turned on for that format in **Tin Man → Preferences → Calibrated QuickLook**.
3. Confirm the file format is supported (see Supported Formats).
4. Make sure Explorer shows thumbnails: use a **Medium**, **Large** or **Extra large icons** view, and in **Folder Options → View**, uncheck **Always show icons, never thumbnails**.
5. Clear the thumbnail cache (above).

### The first preview takes a moment <a href="#user-content-the-first-preview-takes-a-moment" id="user-content-the-first-preview-takes-a-moment"></a>

The first preview after a restart, or after a few minutes without previews, loads the Tin Man Decoding Engine, which takes a second or two. The very first preview on a computer can take longer while GPU caches are built.

### The preview says "Frame decode error." <a href="#user-content-the-preview-says-frame-decode-error" id="user-content-the-preview-says-frame-decode-error"></a>

The clip, or a frame in it, couldn't be decoded. Check that the file plays in Tin Man.

***

### **How to Disable the Calibrated QuickLook Plugin** <a href="#user-content-how-to-disable-the-calibrated-quicklook-plugin" id="user-content-how-to-disable-the-calibrated-quicklook-plugin"></a>

1. Open **Tin Man**.
2. Go to **Preferences → Calibrated QuickLook**.
3. Uncheck **Thumbnails** and/or **Previews** for a format, or uncheck **All** to turn off a whole column.
