Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
c965ded
Initial commit
magicien Nov 17, 2017
f83f1ce
Add files
magicien Nov 18, 2017
7f5b956
Add screenshot.png
magicien Nov 18, 2017
d915c4d
Update README.md
magicien Nov 18, 2017
0dbba22
Add thumbnail support
magicien Nov 19, 2017
cbd139f
Use scn files for preview instead of screenshots
magicien Nov 21, 2017
2221bde
Add screenshots
magicien Nov 21, 2017
ccc7699
Update README.md
magicien Nov 21, 2017
1348b06
v0.2.0
magicien Nov 21, 2017
38319ce
Merge branch 'master' of github:magicien/GLTFQuickLook
magicien Nov 21, 2017
6cd0229
Update README.md
magicien Nov 21, 2017
872af10
Update README.md
magicien Nov 21, 2017
aaaec57
Update README.md
magicien Nov 22, 2017
74ff23a
Handle canceling
magicien Nov 29, 2017
82a146c
v0.2.1
magicien Nov 29, 2017
35d0abe
Merge branch 'master' of github:magicien/GLTFQuickLook
magicien Nov 29, 2017
21703f2
Update GLTFSceneKit (v0.1.2)
magicien Nov 30, 2017
4ec048a
v0.2.2
magicien Nov 30, 2017
371121d
Use Carthage
magicien Dec 15, 2017
d4e4ca6
Update README.md
magicien Dec 15, 2017
1632de3
Create FUNDING.yml
magicien Oct 29, 2019
2daa15e
Update code signing settings
magicien Jul 7, 2021
711e46a
Update README.md
magicien Jul 7, 2021
3cf5ec0
v0.3.0
magicien Jul 7, 2021
c55baa3
feat: Support modern App Extensions for macOS 10.15+
hectorlizard Mar 23, 2026
b0e3035
fix: improve Quick Look scene framing diagnostics
hectorlizard May 29, 2026
d0d0856
feat: add autonomous cache prep for sidecar gltf files
hectorlizard May 29, 2026
fd324ae
feat: watch prepared gltf folders continuously
hectorlizard May 29, 2026
5fbc000
feat: enrich prepared gltf caches with Unreal materials
hectorlizard May 30, 2026
68569b0
feat: ignore unreal red vertex colors in prepared caches
hectorlizard May 30, 2026
572bdbb
feat: watch Downloads for downloaded gltf caches
hectorlizard Jun 1, 2026
4db33f5
fix: stabilize dense gltf quick look rendering
hectorlizard Jun 1, 2026
fdb7d23
fix: avoid heavy host app rescans and memory growth
hectorlizard Jun 1, 2026
cc24b80
fix: let Quick Look provide the native preview background
hectorlizard Aug 30, 2026
228b7d2
fix: support oversized animated uModel characters
hectorlizard Sep 1, 2026
18112a9
Merge remote-tracking branch 'origin/master' into release/v1.1.0-beta.1
hectorlizard Sep 1, 2026
81c1844
chore: prepare 1.1.0 beta release
hectorlizard Sep 2, 2026
19acf89
chore: harden release packaging
hectorlizard Sep 2, 2026
27c307d
docs: preserve current preview animation
hectorlizard Sep 2, 2026
dd7f128
ci: use current checkout runtime
hectorlizard Sep 2, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
name: CI

on:
push:
branches: [master, "release/**"]
pull_request:

jobs:
build:
runs-on: macos-15
steps:
- uses: actions/checkout@v5

- name: Install XcodeGen
run: brew install xcodegen

- name: Check release hygiene
run: Scripts/check-release-hygiene.sh

- name: Generate project
run: xcodegen generate --spec ModernAppExtension/project.yml

- name: Build modern extension
run: |
xcodebuild \
-project ModernAppExtension/GLTFQuickLook.xcodeproj \
-scheme GLTFQuickLook \
-configuration Release \
-derivedDataPath "$RUNNER_TEMP/GLTFQuickLookDerivedData" \
ARCHS=arm64 \
ONLY_ACTIVE_ARCH=NO \
CODE_SIGN_IDENTITY=- \
build

- name: Verify embedded extensions
run: |
APP="$RUNNER_TEMP/GLTFQuickLookDerivedData/Build/Products/Release/GLTFQuickLook.app"
test -d "$APP/Contents/PlugIns/GLTFPreview.appex"
test -d "$APP/Contents/PlugIns/GLTFThumbnail.appex"
codesign --verify --deep --strict "$APP"
68 changes: 68 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
name: Release

on:
push:
tags:
- "v*"
workflow_dispatch:
inputs:
version:
description: Artifact version, for example 1.1.0-beta.1
required: true
default: 1.1.0-beta.1

permissions:
contents: write

jobs:
package:
runs-on: macos-15
steps:
- uses: actions/checkout@v5

- name: Install XcodeGen
run: brew install xcodegen

- name: Select version
id: version
env:
EVENT_NAME: ${{ github.event_name }}
TAG_NAME: ${{ github.ref_name }}
MANUAL_VERSION: ${{ inputs.version }}
run: |
if [[ "$EVENT_NAME" == "push" ]]; then
echo "value=${TAG_NAME#v}" >> "$GITHUB_OUTPUT"
else
echo "value=$MANUAL_VERSION" >> "$GITHUB_OUTPUT"
fi

- name: Build release archive
env:
VERSION: ${{ steps.version.outputs.value }}
DERIVED_DATA: ${{ runner.temp }}/GLTFQuickLookRelease
run: Scripts/package-release.sh

- name: Upload workflow artifact
uses: actions/upload-artifact@v4
with:
name: GLTFQuickLook-${{ steps.version.outputs.value }}-macos-arm64
path: |
dist/*.zip
dist/*.sha256

- name: Publish GitHub release
if: github.event_name == 'push'
env:
GH_TOKEN: ${{ github.token }}
VERSION: ${{ steps.version.outputs.value }}
run: |
prerelease=()
if [[ "$VERSION" == *-* ]]; then
prerelease=(--prerelease)
fi
gh release create "v$VERSION" \
dist/*.zip \
dist/*.sha256 \
--title "GLTFQuickLook $VERSION" \
--generate-notes \
"${prerelease[@]}"
6 changes: 5 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
# Xcode
#
build/
dist/
.DS_Store
**/.DS_Store
*.pbxuser
!default.pbxuser
*.mode1v3
Expand All @@ -13,9 +16,11 @@ xcuserdata
*.xccheckout
*.moved-aside
DerivedData
ModernAppExtension/GLTFQuickLook.xcodeproj/
*.hmap
*.ipa
*.xcuserstate
*.xcresult

# CocoaPods
#
Expand All @@ -35,4 +40,3 @@ Carthage/Build
Framework/
*~
*.swp

30 changes: 30 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Changelog

All notable changes to GLTFQuickLook are documented here.

## 1.1.0-beta.1 - 2026-09-02

### Added

- Autonomous extended-attribute caches for sidecar-based glTF documents.
- Continuous, targeted preparation of Downloads and user-selected folders.
- Unreal `.props.txt` material and texture reconstruction.
- Support for dense Sketchfab documents and oversized animated uModel exports.
- Preservation of the first 10 animations in compacted character caches.
- Skin-weight normalization and optional pure-red vertex-color cleanup.

### Fixed

- Finder thumbnail generation for prepared sidecar documents.
- Quick Look memory growth and repeated full-folder rescans.
- Scene framing and loading stability for large or dense models.
- Light and Dark Mode previews now use the native Quick Look background.

### Distribution

- Requires macOS 12 or later.
- The downloadable beta targets Apple Silicon and is ad hoc signed, not notarized.

## 1.0.1

- Added the first modern Quick Look App Extension implementation.
1 change: 1 addition & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
MIT License

Copyright (c) 2017 magicien
Copyright (c) 2026 Hectorlizard contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
Loading
Loading