https://github.com/arthurrmp/quicklookgltf
macOS Quick Look extension for previewing .glb and .gltf 3D model files. Press Space in Finder to preview.
https://github.com/arthurrmp/quicklookgltf
3d glb gltf macos quick-look quicklook three-js
Last synced: about 2 months ago
JSON representation
macOS Quick Look extension for previewing .glb and .gltf 3D model files. Press Space in Finder to preview.
- Host: GitHub
- URL: https://github.com/arthurrmp/quicklookgltf
- Owner: arthurrmp
- License: mit
- Created: 2026-03-29T00:51:15.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-03-29T20:55:37.000Z (2 months ago)
- Last Synced: 2026-04-04T14:51:01.838Z (2 months ago)
- Topics: 3d, glb, gltf, macos, quick-look, quicklook, three-js
- Language: Swift
- Size: 1.99 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# QuickLookGLTF
**A macOS Quick Look extension for previewing `.glb` and `.gltf` 3D model files.**
Built with [Three.js](https://threejs.org) running inside a WKWebView. Models load instantly thanks to Three.js's optimized glTF parser and GPU-accelerated rendering.
- Preview `.glb` and `.gltf` files with Quick Look (press Space in Finder)
- Orbit, zoom, and pan with mouse/trackpad
- Plays the first animation if the model has one
- Supports Draco, KTX2, and Meshopt compressed models
- Auto-frames the camera to fit the model
- Extensible via [custom scripts](#custom-scripts)
## Install
### Homebrew
```bash
brew install arthurrmp/tap/quicklookgltf
```
### Manual
1. Download `QuickLookGLTF.zip` from the [latest release](https://github.com/arthurrmp/QuickLookGLTF/releases)
2. Unzip and move `QuickLookGLTF.app` to `/Applications`
### After installing
1. Open `QuickLookGLTF.app` from `/Applications` once to register the extension
2. Press Space on any `.glb` or `.gltf` file in Finder
Quick Look not working?
Check that the extension is enabled in System Settings:
- **macOS 15+:** General > Login Items & Extensions > scroll to Extensions > click the info button next to QuickLookGLTF > enable Quick Look
- **macOS 13 and 14:** Privacy & Security > Extensions > Quick Look > enable QuickLookGLTF
## Custom Scripts
You can run a custom JavaScript file after each model loads. Create `~/.config/quicklookgltf/custom.js` and it will be executed with access to `scene`, `camera`, `renderer`, `controls`, `gltf`, and `THREE`.
```js
scene.background = new THREE.Color(0xff0000);
scene.traverse((node) => {
if (node.isMesh && node.material) {
node.material.depthWrite = true;
}
});
```
## Build from source
Requires macOS 13.0+, Xcode 15+, [XcodeGen](https://github.com/yonaskolb/XcodeGen), and Node.js.
```bash
xcodegen
npm install
npm run build
open QuickLookGLTF.xcodeproj
```
To update Three.js:
```bash
npm update three
npm run build
```
## License
MIT
## Acknowledgments
[Three.js](https://threejs.org) - MIT License, Copyright 2010-2026 three.js authors