Modern Quick Look extensions to preview FreeCAD *.FCStd files in Finder. This replaces the legacy qlgenerator and uses current macOS APIs to show the PNG thumbnail embedded in FreeCAD documents.

• Quick Look preview (press Space) shows the embedded Thumbnail.png.
• Finder thumbnails use the same embedded image.

Quick Look preview:

Finder thumbnails:

1. Open the project in Xcode.
2. Select the FreeCAD Companion target and build/run (⌘R) to test.
3. To install for all users:
   • Archive (Product > Archive), export the app, and move it to /Applications.
4. Launch the app once to register the extension.
5. If thumbnails or previews do not appear, refresh Quick Look:

qlmanage -r
killall Finder

Open System Settings > Privacy & Security > Extensions > Quick Look and enable FreeCAD Companion.

• A .FCStd file is a ZIP archive. The extension opens the archive, extracts Thumbnail.png, and renders that image for previews and thumbnails.
• No model parsing — only the embedded PNG is used.

For best results, configure FreeCAD to save a larger thumbnail (256×256 or 512×512): Edit > Preferences > General > Document → Thumbnail size.

• Ensure FreeCAD Companion is enabled in System Settings.
• Run qlmanage -r to reload Quick Look plugins.
• Verify your .FCStd files contain Thumbnail.png (check FreeCAD thumbnail settings).

This project aims to provide a native, future-proof preview experience and is intended for integration into FreeCAD. Licensed under MIT — see LICENSE.