Bug 493474 - Thumbnail and QuickLook previews not displaying on macOS 15 Sequoia
Summary: Thumbnail and QuickLook previews not displaying on macOS 15 Sequoia
Status: RESOLVED FIXED
Alias: None
Product: krita
Classification: Applications
Component: File formats (other bugs)
Version First Reported In: 5.2.3
Platform: macOS (DMG) macOS
: NOR normal
Target Milestone: ---
Assignee: vanyossi
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2024-09-22 11:43 UTC by omnibus.cheeked-0q
Modified: 2025-12-05 05:03 UTC (History)
3 users (show)

See Also:
Latest Commit:
Version Fixed/Implemented In:
Sentry Crash Report:


Attachments
Contains KritaUsageLog.txt, KritaSystemInformation.txt, Test.kra and screenshots of the aforementioned issue. (217.30 KB, application/zip)
2024-09-22 11:43 UTC, omnibus.cheeked-0q
Details

Note You need to log in before you can comment on or make changes to this bug.
Description omnibus.cheeked-0q 2024-09-22 11:43:43 UTC
Created attachment 173959 [details]
Contains KritaUsageLog.txt, KritaSystemInformation.txt, Test.kra and screenshots of the aforementioned issue.

SUMMARY
Apple removed support for deprecated Quick Look Generator plugins (kritaquicklook.qlgenerator) from macOS 15 Sequoia, leading to empty thumbnails for .kra files and broken QuickLook previewing. Please migrate to Quick Look Preview Extension and Thumbnail Extension API. Documentation for developers can be found below.
Forum discussion: https://krita-artists.org/t/icon-thumbnails-not-displaying-on-mac-desktop/102375
macOS Sequoia 15 Release Notes: https://developer.apple.com/documentation/macos-release-notes/macos-15-release-notes#Quick-Look
Apple Developer Documentation Providing Thumbnails of Your Custom File Types: https://developer.apple.com/documentation/quicklookthumbnailing/providing-thumbnails-of-your-custom-file-types
Apple Developer Documentation QuickLook Thumbnailing: https://developer.apple.com/documentation/quicklookthumbnailing
Apple Developer Documentation QuickLookUI: https://developer.apple.com/documentation/QuickLookUI
Apple Developer Documentation QuickLook: https://developer.apple.com/documentation/quicklook

STEPS TO REPRODUCE
1. Install Krita via DMG or Homebrew on macOS 15 Sequoia.
2. Open Krita and save an image in .kra format.
3. Open Finder and find the newly saved .kra file.
OR
1. Upgrade from macOS 14 Sonoma to macOS 15 Sequoia with Krita and .kra files already on macOS 14 Sonoma.
2. Open Finder and find existing .kra files.

OBSERVED RESULT
Thumbnails are not displayed for .kra files. QuickLook preview does not work.

EXPECTED RESULT
Thumbnails should be displayed for .kra files. QuickLook preview should work.

SOFTWARE/OS VERSIONS
Windows: 
macOS: macOS 15.0 Sequoia
(available in the Info Center app, or by running `kinfo` in a terminal window)
Linux/KDE Plasma: 
KDE Plasma Version: 
KDE Frameworks Version: 
Qt Version: 

ADDITIONAL INFORMATION
Comment 1 Halla Rempt 2025-12-03 12:46:59 UTC
Git commit 921f9b73682df40f5194f6e60831c9d4e5460d75 by Halla Rempt, on behalf of Ivan Yossi.
Committed on 03/12/2025 at 12:46.
Pushed by rempt into branch 'master'.

macos: working version of thumbnailer

This adds a PreviewHelper app to embed the thumbnailer to it. We need this
as application extensions does not register to lsregister if they are not
embedded inside a bundle application.

Small fixes to all project configurations

The thumbnailer works as expected, special care needs to be taken with
request.scale as it has the current screen scaling, cgImage need to take
this into account.

M  +184  -10   krita/integration/integration.xcodeproj/project.pbxproj
A  +79   -0    krita/integration/integration.xcodeproj/xcshareddata/xcschemes/kritaquicklookng.xcscheme
A  +11   -0    krita/integration/previewHelper/Assets.xcassets/AccentColor.colorset/Contents.json
A  +58   -0    krita/integration/previewHelper/Assets.xcassets/AppIcon.appiconset/Contents.json
A  +6    -0    krita/integration/previewHelper/Assets.xcassets/Contents.json
A  +24   -0    krita/integration/previewHelper/ContentView.swift
A  +125  -0    krita/integration/previewHelper/Info.plist
A  +18   -0    krita/integration/previewHelper/previewHelperApp.swift
M  +1    -1    krita/integration/quicklookng/Info.plist
M  +58   -30   krita/integration/quicklookng/ThumbnailProvider.swift

https://invent.kde.org/graphics/krita/-/commit/921f9b73682df40f5194f6e60831c9d4e5460d75
Comment 2 Halla Rempt 2025-12-03 12:53:43 UTC
Git commit bd5b2e819731c2ac700fa055310a80a812d67f07 by Halla Rempt, on behalf of Ivan Yossi.
Committed on 03/12/2025 at 12:46.
Pushed by rempt into branch 'master'.

macos: implement preview provider for macos 12 and up

M  +3    -0    krita/integration/CMakeLists.txt
M  +354  -2    krita/integration/integration.xcodeproj/project.pbxproj
A  +95   -0    krita/integration/integration.xcodeproj/xcshareddata/xcschemes/krita-preview.xcscheme
A  +71   -0    krita/integration/integration.xcodeproj/xcshareddata/xcschemes/krita-preview_helper.xcscheme
A  +78   -0    krita/integration/integration.xcodeproj/xcshareddata/xcschemes/previewHelper.xcscheme
A  +21   -0    krita/integration/krita-preview/Base.lproj/PreviewViewController.xib
A  +24   -0    krita/integration/krita-preview/Info.plist
A  +126  -0    krita/integration/krita-preview/PreviewProvider.swift
A  +40   -0    krita/integration/krita-preview/PreviewViewController.swift
A  +24   -0    krita/integration/krita-preview_helper/krita-preview-Info.plist
M  +5    -1    packaging/macos/osxdeploy.sh

https://invent.kde.org/graphics/krita/-/commit/bd5b2e819731c2ac700fa055310a80a812d67f07
Comment 3 vanyossi 2025-12-05 04:57:05 UTC
Git commit 955bbc3d6cb3210910cc99413905ab31123285b9 by Ivan Yossi.
Committed on 04/12/2025 at 17:42.
Pushed by ivany into branch 'krita/5.2'.

macos: working version of thumbnailer

This adds a PreviewHelper app to embed the thumbnailer to it. We need this
as application extensions does not register to lsregister if they are not
embedded inside a bundle application.

Small fixes to all project configurations

The thumbnailer works as expected, special care needs to be taken with
request.scale as it has the current screen scaling, cgImage need to take
this into account.
(cherry picked from commit 921f9b73682df40f5194f6e60831c9d4e5460d75)

M  +184  -10   krita/integration/integration.xcodeproj/project.pbxproj
A  +79   -0    krita/integration/integration.xcodeproj/xcshareddata/xcschemes/kritaquicklookng.xcscheme
A  +11   -0    krita/integration/previewHelper/Assets.xcassets/AccentColor.colorset/Contents.json
A  +58   -0    krita/integration/previewHelper/Assets.xcassets/AppIcon.appiconset/Contents.json
A  +6    -0    krita/integration/previewHelper/Assets.xcassets/Contents.json
A  +24   -0    krita/integration/previewHelper/ContentView.swift
A  +125  -0    krita/integration/previewHelper/Info.plist
A  +18   -0    krita/integration/previewHelper/previewHelperApp.swift
M  +1    -1    krita/integration/quicklookng/Info.plist
M  +58   -30   krita/integration/quicklookng/ThumbnailProvider.swift

https://invent.kde.org/graphics/krita/-/commit/955bbc3d6cb3210910cc99413905ab31123285b9
Comment 4 vanyossi 2025-12-05 05:03:50 UTC
Git commit 0f307e5d165099e6c2f67c0fbf8cb8ec21f7c1c8 by Ivan Yossi.
Committed on 04/12/2025 at 17:42.
Pushed by ivany into branch 'krita/5.2'.

macos: implement preview provider for macos 12 and up
(cherry picked from commit bd5b2e819731c2ac700fa055310a80a812d67f07)

M  +3    -0    krita/integration/CMakeLists.txt
M  +354  -2    krita/integration/integration.xcodeproj/project.pbxproj
A  +95   -0    krita/integration/integration.xcodeproj/xcshareddata/xcschemes/krita-preview.xcscheme
A  +71   -0    krita/integration/integration.xcodeproj/xcshareddata/xcschemes/krita-preview_helper.xcscheme
A  +78   -0    krita/integration/integration.xcodeproj/xcshareddata/xcschemes/previewHelper.xcscheme
A  +21   -0    krita/integration/krita-preview/Base.lproj/PreviewViewController.xib
A  +24   -0    krita/integration/krita-preview/Info.plist
A  +126  -0    krita/integration/krita-preview/PreviewProvider.swift
A  +40   -0    krita/integration/krita-preview/PreviewViewController.swift
A  +24   -0    krita/integration/krita-preview_helper/krita-preview-Info.plist
M  +5    -1    packaging/macos/osxdeploy.sh

https://invent.kde.org/graphics/krita/-/commit/0f307e5d165099e6c2f67c0fbf8cb8ec21f7c1c8