<img src="assets/readme/mkrshift-nodes-banner.svg" alt="MKRShift Nodes" width="920" /> Creative direction, look development, masking, media finishing, and publish/output nodes for ComfyUI. Built for day-to-day production workflows: fast iteration, stronger previews, and practical utility nodes that reduce graph clutter.

Overview

MKRShift Nodes is a broad ComfyUI node pack focused on image craft and workflow speed. It combines creative tools, utility nodes, custom frontend helpers, and publish/output nodes in one pack instead of splitting related tasks across multiple small installs.

Node Areas

| Area | Example Nodes | Focus | | --- | --- | --- | | Direction | MKRCharacterCustomizer, MKRCharacterState, MKROutfitSet, MKRPoseStudio, AngleShift, Aspect1X, AxBCompare | Character setup, persistent identity state, outfit variation, 3D pose blockout, angle exploration, compare views, and framing | | Blender Bridge | MKRBlenderSceneImport, MKRBlenderCameraShot, MKRBlenderImageImport, MKRBlenderImageOutputPlan, MKRBlenderMaterialImport, MKRBlenderMaterialReturnPlan, MKRBlenderReturnPlan | Import Blender camera, armature, image, and material payloads, derive shot/material metadata, and build return plans for roundtrip workflows | | Host Addons | MKRBlenderSceneImport, MKRTouchDesignerImport, MKRTiXLImport, MKRNukeScriptImport, MKRPhotoshopDocumentImport, MKRAfterEffectsCompImport, MKRPremiereSequenceImport, MKRAffinityDocumentImport, MKRAffinityPhotoshopPluginPlan, MKRFusion360SceneImport, MKRFusion360ImageImport, MKRMayaSceneImport, MKRMayaImageImport, MKRNodeExtensionBuilderAdvanced, MKRNodeExtensionBuilderPlan, MKRNodeExtensionPyprojectPlan | Packet-first host integrations with per-application addon scaffolds under addons/ and matching ComfyUI nodes under Addons/..., including image/texture handoff lanes for the 3D hosts, an Affinity route based on Photoshop-plugin compatibility, plus an extension-builder lane with a cleaner advanced sidecar node for repository/license/tag metadata, manifest planning, and registry-ready pyproject.toml drafting | | Network Transport | MKRAddonEndpointPlan, MKROSCMessagePlan, MKRNDIStreamPlan, MKRSpoutSenderPlan, MKRSyphonSenderPlan, MKRTCPBridgePlan, MKRHTTPWebhookPlan, MKRWatchFolderPlan, MKRWebSocketBridgePlan | Reusable endpoint and transport plans for host add-ons, including HTTP endpoint jobs, OSC, NDI, Spout, Syphon, TCP, watch-folder, and WebSocket workflows | | Surface + Material | x1PreviewMaterial, x1PBRPack, x1ClearcoatMap, x1ClearcoatRoughnessMap, x1EdgeWearMask, x1TextureDetileBlend | Practical PBR map derivation, material preview, packing, wear masking, and anti-tiling texture cleanup | | Color + Lookdev | xLUT, xLUTOutput, x1ColorWheels, x1Curves, x1ColorWarpHueSat, x1ColorWarpChromaLuma, x1PaletteMap | LUT authoring, grading, color matching, mesh-based warping, and look building | | Image Processing | x1Bloom, x1Film, x1Stylize, x1LocalContrast, x1SharpenPro, x1LightWrapComposite, x1EdgeAberration | Finishing, texture, stylization, polish, and practical comp/VFX passes | | Inspect + Review | AxBCompare, MKRBatchCollagePreview, MKRStudioReviewFrame, MKRStudioCompareBoard | Fast side-by-side checks, labeled batch sheets, and review-ready boards | | Mask + Utility | x1MaskGen, AdvResize, MKRImageSplitGrid, MKRImageCombineGrid, MKRPixelPaletteReduce, MKRSpriteSheetExtract, xShader, x1DenoiseDetail | Mask generation, resize work, tiled image workflows, pixel-art palette reduction, sprite extraction, shader utilities, and cleanup | | PreSave + Media | MKRPreSave, MKRPresaveVideo, MKRPresaveAudio, MKRMuxVideoAudio, MKRTrimVideoByTime | Preview-first export helpers plus audio/video utility work | | Publish + Output | MKRPublishPromoFrame, MKRPublishEndCard, MKRPublishAssetManifest, MKRPublishManifestAtIndex, MKRPublishCopyDeck, MKRPublishCopyAtIndex | Promo-card framing, end cards, asset manifests, and copy extraction helpers for real export/delivery work | | G-code | MKRGCodePrinterProfile, MKRGCodeOrcaProfileLoader, MKRGCodeLoadMeshModel, MKRGCodeHeightmapPlate, MKRGCodeSpiralVase, MKRGCodePlanAnalyzer, MKRGCodeBedMeshCompensate, MKRGCodeCalibrationTower, MKRGCodeConditionalInjector, MKRGCodePreview, MKRGCodeExternalSlicer, MKRGCodeExport | 3D-print printer profiles, Orca preset import, mesh/model loading, generators, plan analysis, bed compensation, calibration macros, preview, external slicing, and direct .gcode export | | Studio Review + Delivery | MKRStudioSlate, MKRStudioReviewFrame, MKRStudioReviewBurnIn, MKRStudioCompareBoard, MKRStudioContactSheet, MKRStudioDeliveryPlan | Branded slates, quick burn-ins, compare boards, review frames, contact sheets, and naming/handoff planning for internal or client-facing review |

Frontend Extensions

This pack ships custom WEB_DIRECTORY extensions for nodes that benefit from a better UI:

MKRCharacterCustomizer
MKRCharacterState
AngleShift
MKRPoseStudio
AxBCompare
MKRPreSave
MKRPresaveVideo
MKRPresaveAudio
MKRPublishPromoFrame
x1ColorWheels
x1Curves
x1ColorWarpHueSat
x1ColorWarpChromaLuma
xLUT
x1MaskGen

Markdown help pages for these nodes live in web/docs/.

If you publish/maintain a GitHub wiki, use web/docs/Home.md as the landing page and web/docs/_Sidebar.md for wiki navigation. Those pages are organized to mirror the current in-app taxonomy, including the refreshed Surface and Inspect branches.

The Blender add-on scaffold for the bridge lives in blender_extension/mkrshift_blender_bridge/.

This pack now also exposes an initial V3 schema companion lane through:

v3_extension.py

That V3 lane currently focuses on the newer addon/network transport nodes where V3 schema definitions are low-risk and useful.

Additional host integration scaffolds now live in addons/:

addons/blender/
addons/touchdesigner/
addons/tixl/
addons/nuke/
addons/photoshop/
addons/after_effects/
addons/premiere_pro/
addons/affinity/
addons/fusion360/
addons/maya/

Subgraph blueprints for the addon/network lane live in subgraphs/.

Installation

Clone or copy this folder into ComfyUI/custom_nodes/.
Restart ComfyUI.
Install ffmpeg if you plan to use the video/audio export and muxing nodes.
Install OrcaSlicer, PrusaSlicer, or CuraEngine if you plan to use the external G-code slicer node.

Extension Builder Quickstart

This repo now includes a starter builder config at extension.builder.json and a minimal example workflow at example_workflows/mkrshift_extension_builder_plan.json for MKRNodeExtensionBuilderPlan, the MKRNodeExtensionBuilderAdvanced sidecar node, and MKRNodeExtensionPyprojectPlan.

Suggested build command:

python3 /opt/codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo criskb/comfyui-node-extension-builder --path . --name comfyui-node-extension-builder

Then write the builder_manifest_json output from MKRNodeExtensionBuilderPlan to extension.builder.json and run your preferred builder CLI. For cleaner graphs, keep expert metadata on MKRNodeExtensionBuilderAdvanced, connect its advanced_options_json output into advanced_bundle_json on the plan node, and feed the resulting manifest into MKRNodeExtensionPyprojectPlan when you want a matching pyproject.toml draft.

Notes

pyproject.toml is included so the pack has a stable package identity.
pyproject.toml now includes repository and Comfy registry metadata for packaging/distribution readiness.
The code uses relative imports and does not rely on the install folder matching the repo name.
Package internals are split by concern under nodes/ and lib/, with legacy root import aliases preserved for backward compatibility.
The G-code category is inspired by the earlier G-code-Studio experiment, but implemented here as ComfyUI-native nodes.
The external slicer node can run in dry_run mode to validate commands/config text even when a slicer CLI is not installed yet.
G-code post-processing nodes expect exported layer comments for the strongest results, so keep include_comments enabled on MKRGCodeExport when you plan to inject calibration or conditional macros later in the graph.

Verification

Run the test suite with:

python3 -m unittest discover -s tests -p 'test_*.py'

The current checks cover:

pack importability
exported node metadata
WEB_DIRECTORY presence
docs and packaging assets
publish/output and mask feature regressions
studio review node coverage and legacy import aliases

This extension/addon was created using Codex skill designed by Cris K B https://github.com/criskb/comfyui-node-extension-builder