Quick Look 3D Plugin

English | 日本語 | 한국어

A macOS Quick Look plugin that previews .vrm / .vrma / .glb / .fbx files in 3D.

Select a file in Finder and press Space to spin the model around. Animations play automatically.

Install

1. Download QuickLook3D.dmg from the latest release and open it
2. Drag QuickLook3D.app into your Applications folder
3. Launch the app once — this registers the Quick Look extension with macOS (you can close the window afterwards)
4. Open System Settings → General → Login Items & Extensions → Extensions (Quick Look) and turn on Quick Look 3D

The released build is notarized by Apple, so Gatekeeper won't warn you.

Usage

Select a supported file in Finder and press Space (or right-click → Quick Look).

Format	Notes
.vrm	VRM avatar (0.x / 1.0)
.vrma	VRM animation. No mesh, so the skeleton is shown and the animation plays
.glb	glTF binary. Plays embedded animation if present
.fbx	FBX model. Plays embedded animation if present

• Drag to rotate, scroll to zoom
• Files with no mesh/skin (a skin-less .fbx, or .vrma) are shown as a skeleton

Troubleshooting

• Make sure install steps 3–4 (launch once and enable the extension) are done
• Otherwise refresh the Quick Look cache:

  qlmanage -r && qlmanage -r cache

• .gltf (the multi-file form with external .bin / textures) is not supported. Use a single-file .glb instead.

License

The project code is MIT. The bundled third parties (three.js / @pixiv/three-vrm / fflate) are also MIT — see THIRD_PARTY_LICENSES.md. No avatar or model data is bundled.

For developers

Build instructions, architecture, and distribution (signing / notarization) are in docs/DEVELOPMENT.md.