https://github.com/sawa-zen/quick-look-3d
macOS Quick Look plugin that previews VRM, VRMA, GLB and FBX 3D models — powered by Three.js
https://github.com/sawa-zen/quick-look-3d
3d avatar fbx glb macos quick-look-plugin quicklook swift three-vrm threejs vrm vrma webgl
Last synced: about 20 hours ago
JSON representation
macOS Quick Look plugin that previews VRM, VRMA, GLB and FBX 3D models — powered by Three.js
- Host: GitHub
- URL: https://github.com/sawa-zen/quick-look-3d
- Owner: sawa-zen
- License: mit
- Created: 2026-06-14T00:48:49.000Z (4 days ago)
- Default Branch: main
- Last Pushed: 2026-06-16T07:41:18.000Z (1 day ago)
- Last Synced: 2026-06-16T07:50:11.907Z (1 day ago)
- Topics: 3d, avatar, fbx, glb, macos, quick-look-plugin, quicklook, swift, three-vrm, threejs, vrm, vrma, webgl
- Language: TypeScript
- Homepage:
- Size: 7.92 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.ja.md
- License: LICENSE
Awesome Lists containing this project
README
# Quick Look 3D Plugin
[English](./README.md) | **日本語** | [한국어](./README.ko.md)
macOS の Quick Look で **`.vrm` / `.vrma` / `.glb` / `.fbx`** を 3D プレビューするプラグイン。
Finder でファイルを選んでスペースキーを押すと、モデルをぐりぐり回して確認できる。
アニメーションが含まれていれば自動再生する。
## インストール
1. [Releases](https://github.com/sawa-zen/quick-look-3d/releases/latest) から
`QuickLook3D.dmg` をダウンロードして開く
2. **QuickLook3D.app** を「アプリケーション」フォルダにドラッグ
3. **一度アプリを起動する**（これで Quick Look 拡張機能が macOS に登録される。
ウィンドウは閉じてよい）
4. **システム設定 → 一般 → ログイン項目と機能拡張 → 機能拡張（Quick Look）** を開き、
**Quick Look 3D** をオンにする
> 配布物は Apple の公証（Notarization）済みなので、Gatekeeper の警告は出ません。
## 使い方
Finder で対応ファイルを選んで **スペースキー**（または右クリック → クイックルック）。
| 形式 | 内容 |
|---|---|
| `.vrm` | VRM アバター（0.x / 1.0 両対応） |
| `.vrma` | VRM アニメーション。メッシュが無いのでボーンをスケルトン表示して再生 |
| `.glb` | glTF バイナリ。アニメーションがあれば自動再生 |
| `.fbx` | FBX モデル。アニメーションがあれば自動再生 |
- マウスドラッグで回転、スクロールでズーム
- スキン（メッシュ）を持たない `.fbx` や `.vrma` は、骨格（スケルトン）として表示される
## うまく表示されないとき
- インストール手順 3〜4（**一度起動** と **機能拡張をオン**）が済んでいるか確認
- それでもダメなら Quick Look のキャッシュを更新:
```bash
qlmanage -r && qlmanage -r cache
```
- `.gltf`（分割型 = `.bin` やテクスチャが別ファイル）は非対応。単一ファイルの `.glb` を使う
## ライセンス
本体コードは [MIT License](./LICENSE)。同梱するサードパーティ（three.js / @pixiv/three-vrm /
fflate）も MIT で、詳細は [THIRD_PARTY_LICENSES.md](./THIRD_PARTY_LICENSES.md)。
アバター等のモデルデータは同梱していない。
## 開発者向け
ビルド方法・アーキテクチャ・配布（署名/公証）手順は
**[docs/DEVELOPMENT.ja.md](./docs/DEVELOPMENT.ja.md)** を参照。