{"id":50932083,"url":"https://github.com/sawa-zen/quick-look-3d","last_synced_at":"2026-06-17T05:05:58.351Z","repository":{"id":364949561,"uuid":"1268809145","full_name":"sawa-zen/quick-look-3d","owner":"sawa-zen","description":"macOS Quick Look plugin that previews VRM, VRMA, GLB and FBX 3D models — powered by Three.js","archived":false,"fork":false,"pushed_at":"2026-06-16T07:41:18.000Z","size":8300,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-16T07:50:11.907Z","etag":null,"topics":["3d","avatar","fbx","glb","macos","quick-look-plugin","quicklook","swift","three-vrm","threejs","vrm","vrma","webgl"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sawa-zen.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-14T00:48:49.000Z","updated_at":"2026-06-16T07:41:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sawa-zen/quick-look-3d","commit_stats":null,"previous_names":["sawa-zen/3d-quick-look-plugin","sawa-zen/quick-look-3d"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/sawa-zen/quick-look-3d","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fquick-look-3d","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fquick-look-3d/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fquick-look-3d/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fquick-look-3d/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sawa-zen","download_url":"https://codeload.github.com/sawa-zen/quick-look-3d/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fquick-look-3d/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34434534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","avatar","fbx","glb","macos","quick-look-plugin","quicklook","swift","three-vrm","threejs","vrm","vrma","webgl"],"created_at":"2026-06-17T05:05:57.562Z","updated_at":"2026-06-17T05:05:58.345Z","avatar_url":"https://github.com/sawa-zen.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quick Look 3D Plugin\n\n[English](./README.md) | **日本語** | [한국어](./README.ko.md)\n\nmacOS の Quick Look で **`.vrm` / `.vrma` / `.glb` / `.fbx`** を 3D プレビューするプラグイン。\n\nFinder でファイルを選んでスペースキーを押すと、モデルをぐりぐり回して確認できる。\nアニメーションが含まれていれば自動再生する。\n\n![Quick Look 3D デモ](docs/demo.gif)\n\n## インストール\n\n1. [Releases](https://github.com/sawa-zen/quick-look-3d/releases/latest) から\n   `QuickLook3D.dmg` をダウンロードして開く\n2. **QuickLook3D.app** を「アプリケーション」フォルダにドラッグ\n3. **一度アプリを起動する**（これで Quick Look 拡張機能が macOS に登録される。\n   ウィンドウは閉じてよい）\n4. **システム設定 → 一般 → ログイン項目と機能拡張 → 機能拡張（Quick Look）** を開き、\n   **Quick Look 3D** をオンにする\n\n\u003e 配布物は Apple の公証（Notarization）済みなので、Gatekeeper の警告は出ません。\n\n## 使い方\n\nFinder で対応ファイルを選んで **スペースキー**（または右クリック → クイックルック）。\n\n| 形式 | 内容 |\n|---|---|\n| `.vrm` | VRM アバター（0.x / 1.0 両対応） |\n| `.vrma` | VRM アニメーション。メッシュが無いのでボーンをスケルトン表示して再生 |\n| `.glb` | glTF バイナリ。アニメーションがあれば自動再生 |\n| `.fbx` | FBX モデル。アニメーションがあれば自動再生 |\n\n- マウスドラッグで回転、スクロールでズーム\n- スキン（メッシュ）を持たない `.fbx` や `.vrma` は、骨格（スケルトン）として表示される\n\n## うまく表示されないとき\n\n- インストール手順 3〜4（**一度起動** と **機能拡張をオン**）が済んでいるか確認\n- それでもダメなら Quick Look のキャッシュを更新:\n  ```bash\n  qlmanage -r \u0026\u0026 qlmanage -r cache\n  ```\n- `.gltf`（分割型 = `.bin` やテクスチャが別ファイル）は非対応。単一ファイルの `.glb` を使う\n\n## ライセンス\n\n本体コードは [MIT License](./LICENSE)。同梱するサードパーティ（three.js / @pixiv/three-vrm /\nfflate）も MIT で、詳細は [THIRD_PARTY_LICENSES.md](./THIRD_PARTY_LICENSES.md)。\nアバター等のモデルデータは同梱していない。\n\n## 開発者向け\n\nビルド方法・アーキテクチャ・配布（署名/公証）手順は\n**[docs/DEVELOPMENT.ja.md](./docs/DEVELOPMENT.ja.md)** を参照。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsawa-zen%2Fquick-look-3d","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsawa-zen%2Fquick-look-3d","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsawa-zen%2Fquick-look-3d/lists"}