macOS Quick Look extension

Preview .3mf files instantly

A 3MF viewer for Mac built into Quick Look. Press Space to open a .3mf file on Mac and see a 3D preview of the model โ€” no slicer needed.

Free & open source ยท Universal (Apple Silicon + Intel) ยท Signed & notarized ยท macOS 13+

Preview3MF showing a 3D model on a build-plate grid in Quick Look

Everything you need to peek inside a print

A proper 3D preview right in Finder and Quick Look, plus a 3MF thumbnail in Finder on every icon.

๐Ÿ”Ž

Quick Look integration

Press Space in Finder โ€” the model appears, no app to open.

๐ŸงŠ

Real 3D rendering

SceneKit with proper lighting, shading, and materials.

๐ŸŒ€

Auto-rotating

Spins around the vertical axis so you see every side.

๐Ÿ–ฑ๏ธ

Interactive controls

Orbit and zoom with your mouse or trackpad in the preview.

๐ŸŽจ

Color support

Renders per-object and per-triangle material colors when present.

๐Ÿ“

Model info overlay

Triangle count, object count, and dimensions parsed from the file.

๐Ÿ–ผ๏ธ

Finder thumbnails

Rendered icons for .3mf files, reusing the slicer's embedded preview when available.

๐Ÿงฉ

Multi-object & assemblies

Handles Bambu Studio, PrusaSlicer, and component assemblies.

๐ŸŒ—

Dark mode

Preview and app adapt to your system appearance.

โฌ†๏ธ

Automatic updates

New versions arrive on their own, signature-verified before installing.

Installation

Takes about a minute.

  1. Download the latest release and unzip it.
  2. Move Preview3MF.app to /Applications.
  3. Launch it once โ€” this registers the Quick Look extensions.
  4. Go to System Settings โ†’ Privacy & Security โ†’ Extensions โ†’ Quick Look and enable both PreviewExtension and ThumbnailExtension.
  5. That's it โ€” press Space on any .3mf file in Finder.

๐Ÿ’ก If Quick Look doesn't pick it up immediately, run qlmanage -r in Terminal to reset the Quick Look cache.

How it works

A .3mf file is a ZIP archive of XML model data.

Extract & parse. Preview3MF pulls the .model files from the archive and reads the vertices, triangles, build items, materials, and metadata.

Resolve assemblies. Component references are expanded so assembly objects become their part meshes with composed transforms.

Render. It builds SceneKit geometry with per-face normals for flat shading, a build-plate grid, three-point lighting, and an auto-framed camera.

Thumbnails. Slicers usually bake a rendered PNG into the package โ€” the thumbnail extension reuses that as a fast path and only falls back to SceneKit when none is present.

Frequently asked questions

Everything about previewing and opening .3mf files on a Mac.

How do I preview a .3mf file on Mac?

Install Preview3MF, then select any .3mf file in Finder and press Space. Quick Look opens a real 3D preview of the model that you can orbit and zoom โ€” no slicer and no extra app to launch.

Why don't my .3mf files show thumbnails in Finder?

By default macOS has no idea how to render .3mf files, so they fall back to a generic icon. Preview3MF adds a thumbnail extension that draws a proper 3MF thumbnail in Finder โ€” reusing the slicer's embedded preview image when there is one, and rendering the mesh itself when there isn't.

If icons don't refresh right away, run qlmanage -r in Terminal to reset the Quick Look cache.

Do I need Bambu Studio or PrusaSlicer to open a .3mf file?

No. Preview3MF reads .3mf files directly, so you can open and inspect a model without launching Bambu Studio, PrusaSlicer, or Orca. It handles files exported by all of them, including multi-object plates and component assemblies.

What is a .3mf file?

3MF (3D Manufacturing Format) is a modern file format for 3D printing โ€” a ZIP archive of XML that stores the mesh along with colors, materials, and print metadata. It's the default project format for slicers like Bambu Studio and PrusaSlicer, and unlike .stl it can carry multiple objects, colors, and units in a single file.

Is Preview3MF free?

Yes โ€” it's completely free and open source under the MIT License. The builds on the releases page are signed and notarized by Apple, so Gatekeeper opens them without warnings.

Which Macs and macOS versions are supported?

Preview3MF runs on macOS 13 (Ventura) and later and ships as a universal binary, so it runs natively on both Apple Silicon and Intel Macs.