Compatibility#
Note
When using custom Krita builds with Python 3.14, most Prism Plus plugins will not be available inside Krita. These plugins currently support Python 3.13 and below. Make sure the installed Krita build ships with a supported Python version if you're relying on those plugins.
Setup#
Prism User Settings > DCCs apps > Krita > Add.Note
Krita's installation folder and the resource folder are located in different places, even in the case of portable installations.
Make sure to select Krita's active resource folder in the Prism Settings. To find the active resource folder in Krita, open the Krita Settings:
Settings > Manage Resources > Open Resource Folder
These are the default locations:
Platform |
Resource Folder |
|---|---|
Windows |
|
Linux |
|
macOS |
|
Settings > Configure Krita > Python Plugin Manager (1), enable
"Prism Pipeline" (2), and restart Krita again:![[Krita - Setup]](../../_static/plugins/krita/01_Krita_Setup.png)
Portable Installations#
bin/krita.exe executable is not automatically the resource location.Updating and Removing the Prism integration#
Prism User Settings > DCCs apps > Krita > Add.Prism User Settings > DCCs apps > Krita > Remove.Accessing Prism in Krita#
Prism Tool |
Description |
|---|---|
Save Version |
Save and version up the scene. |
Save with Comment |
Save, version up the scene, choose a scene format (.kra/.psd) and add a description/thumbnail. |
Export Images |
Publish an image version to the current Prism project. |
Project Browser |
Open the Project Browser to browse scenes and published media. |
Prism Settings |
Open the Prism Settings to configure Prism. |
![[Krita - Access]](../../_static/plugins/krita/02_Krita_Access.png)
Hint
The action definitions also appear in Krita's keyboard shortcut settings. No default global shortcuts are assigned.
Saving Scenefiles#
![[Krita - Save]](../../_static/plugins/krita/03_Krita_Save.png)
.kra or .psd file format. An unnamed document or a document imported from an image defaults to .kra.Hint
KRA is the recommended native working format. PSD interoperability uses Krita's PSD codec but Photoshop-specific features are not guaranteed to round-trip.
Keep a KRA working copy for artwork that uses Krita-specific features.
Importing Images#
![[Krita - Import]](../../_static/plugins/krita/04_Krita_Import.png)
"New document": Opens the image in a separate Krita document.
"Paint layer": Places the image in the active document as a new paint layer.
Hint
The "Paint-layer" import requires an active document. The imported layer is named after the source file, placed above the active layer in its group, and uses the target document's color model, depth and profile.
The image is placed at canvas origin without automatically scaling the image or changing the canvas size. Larger images can extend beyond the visible canvas.
Importing a floating-point EXR into an integer-depth document converts it to the target depth. Use a floating-point target when preserving HDR values matters.
.png, .jpg, .jpeg, .tif, .tiff and .exr.Hint
If a media version with multiple frames is selected, only the displayed frame is imported, not the complete animation.
Exporting Images#
![[Krita - Export]](../../_static/plugins/krita/05_Krita_Export.png)
Hint
Exports contain the flattened document projection, not individual layers.
Note
To export images, the Krita scene must already be saved to the current Prism project.
Format Behavior#
Format |
Default behavior |
|---|---|
PNG |
Alpha enabled, compression level 6, non-indexed output. |
JPEG |
Quality 95, sRGB output and a white matte for transparency. JPEG is lossy and has no alpha channel. |
TIFF |
Flattened output with alpha. Source depth is retained where supported by Krita's codec. |
OpenEXR |
Flattened floating-point output. Integer documents are converted on a clone using an available linear floating-point profile. |
Environment Variables#
The Krita plugin can be controlled using the following environment variables:
Name |
Description |
|---|---|
PRISM_KRITA_EXECUTABLE |
Sets the default Krita executable when enabling the executable override in the Prism User Settings, which is used when opening Krita scenefiles from Prism Standalone. |
PRISM_KRITA_RESOURCES |
Overrides Prism's default integration-folder suggestion. It does not change Krita's own resource settings. |
Frequently Asked Questions#
Why is Prism missing from Krita's Python Plugin Manager?
Check the resource folder currently used by Krita and confirm that
pykrita/prism_krita.desktopexists there.Restart Krita after installation.
Make sure the Krita build includes Python scripting support.
Why is the Prism plugin in Krita disabled or failing to load?
Check the disabled entry's error information in the Python Plugin Manager.
Verify that the Prism root and plugin source folder configured in
pykrita/prism_krita/prism_krita.jsonstill exist.
Why can I not export to a Prism project?
To export images, the Krita scene must already be saved to the current Prism project.
Check the selected output location and write permissions for the folder.
Are animation, linked layers and per-layer exports supported?
This version supports importing still images as documents or paint layers, and exporting flattened documents. More features will be added in future versions.
![[Logo: Krita]](../../_static/banner_logos/krita_logo.png)