# Krita's macOS integration

This Xcode project generates QuickLook (macOS < 10.15), QuickLook Thumbnailing
(macOS 10.15+) and Spotlight plugins for .kra and .ora files.

The QuickLook plugins take the `preview.png` image in the root of the ZIP
container and use it as the thumbnail image, and the `mergedimage.png` file as
the preview image. On files created with older versions of Krita that do not
have `mergedimage.png`, QuickLook will simply fall back to using the thumbnail
image instead.

The Spotlight plugin extracts the following metadata from the kra file, if
available:
- image dimensions, DPI, bit depth, and color space
- color space profile name (not the actual name, as it's not embedded in the container; only the file path)
- layer names
- authors, image title and description

# Installing

Compile the project using Xcode or the provided CMake file. Find the build
output folder (depends on how you configured the project), and place:
- `kritaquicklook.qlgenerator` inside `~/Library/QuickLook`
- `kritaspotlight.mdimporter` inside `~/Library/Spotlight`.

You can also place them in the system folders (`/Library/QuickLook` and
`/Library/Spotlight` respectively). Test that they have been properly installed
with:
- QuickLook: `qlmanage -d2 -p <path to a kra file>; qlmanage -d2 -t <path to a kra file>`
- Spotlight: `mdimport -d2 -t <path to a kra file>`

Be sure to reset QuickLook with `qlmanage -r` and `qlmanage -r cache`. If the
changes don't happen right away, `killall Finder`.

**NOTE 1:** `kritaquicklookng.appex` **cannot be used standalone. You must bundle it with Krita (see below).**

**NOTE 2:** If you have krita installed to `/Applications`, Quicklook will always find
first `kritaquicklook.qlgenerator` from `/Applications/krita.app` application
bundle.

# Bundling

If you package Krita, place:
- `kritaquicklook.qlgenerator` inside `krita.app/Contents/Library/QuickLook`
- `kritaspotlight.mdimporter` inside `krita.app/Contents/Library/Spotlight`
- `kritaquicklookng.appex` inside `krita.app/Contents/Library/PlugIns`
Ensure the app is defined as the default app for opening .kra and .ora files,
and codesign it whole if necessary.

# Hacking
After applying changes and compiling, test your changes as instructed below.
- Quicklook: run in terminal: `qlmanage -g <path to kritaquicklook.qlgenerator> -c image -d2 -p <path to a kra file>`
- Spotlight: install `kritaspotlight.mdimporter` inside `~/Library/Spotlight` and
clear caches, then run `mdimport -d2 -t <path to a kra file>`. Installed
mdimporter will be first in the list when running `mdimport -L`.