ComfySketch Pro

Full-featured digital painting app running as a ComfyUI custom node

ComfySketch Pro is a browser-based painting editor embedded directly inside ComfyUI. It runs in a fullscreen overlay, supports pen tablet pressure, layers, bezier paths, text, gradients, 3D model viewing, and direct AI generation — all without leaving your workflow.

How to open: Click the Sketch button on the ComfySketch Pro node to enter fullscreen editing mode. Canvas data is automatically saved and restored between sessions.

Node Outputs

Output	Format	Description
image	(1, H, W, 3) float32	All visible layers composited as RGB
mask	(1, H, W) float32	Designated mask layer — white=1.0, black=0.0

Interface Layout

Toolbar (top)All tool buttons, file menu, undo/redo, zoom, mirror, flip, and settings.

Options bar (top)Context-sensitive controls for the active tool — size, opacity, flow, stabilization. Double-click any tool button to open its full properties panel.

Canvas (center)Drawing area. Zoom, pan, and rotate freely. Canvas rotation is view-only and doesn't affect pixel data.

Layers panel (right)Full layer stack with thumbnails, visibility, opacity, blend mode, and action buttons.

Color panel (right)HSV color wheel, hex input, foreground/background swatches, and saved palettes.

Run panel (right)Workflow execution and Quick Gen tab for direct AI generation.

Tip: Press Space to hide/show all panels for a distraction-free full-canvas view.

Canvas Setup

Set canvas size via the node's preset_size dropdown or enter custom width/height. Supported range: 64–4096 px per side.

Size Presets

Name	Dimensions	Use case
Square SD	512 × 512	Standard diffusion square
Portrait SD	512 × 768	Portrait diffusion
Landscape SD	768 × 512	Landscape diffusion
Portrait medium	768 × 1024	SDXL portrait
Landscape medium	1024 × 768	SDXL landscape
Square large	1024 × 1024	SDXL square
Phone portrait	1080 × 1920	Mobile
HD landscape	1920 × 1080	HD widescreen

Multiple Canvases

ComfySketch Pro supports multiple independent canvases (documents). Use the Canvases button in the toolbar (document icon next to the file button) to open the canvas switcher.

Switch canvasClick any canvas in the switcher dropdown to make it active

New canvasFile → New Canvas — creates a fresh canvas at the current size

Clear canvasFile → Clear Canvas — wipes all layers on the current canvas

Note: Each canvas has its own layer stack, undo history, and settings. Switching between canvases preserves your work on each one.

Pencil Paint

Realistic graphite pencil with tapered strokes and paper texture. The alpha tip gives it authentic grain that builds up naturally with repeated passes, simulating real pencil on paper.

Options

SizeDefault 12 px max 50 px

OpacityDefault 90%

FlowDefault 18% — low flow means each stamp is very light; multiple passes build up tone

TaperLength of the taper at stroke start/end 0–20

StabilizationDefault 6 — low smoothing for natural hand feel

TextureBristol paper at 30% strength by default

PressureAffects both size and opacity — light touch gives fine hairlines

Tip: Layer multiple strokes with low flow to build up dark areas gradually, just like real graphite. Use size jitter (default 12%) for organic variation.

Ink Paint

Fine ink pen with sharp pressure-responsive tapers. Ideal for precise linework, comic inking, and technical illustration. High stabilization produces smooth, clean curves.

Options

SizeDefault 9 px max 30 px

OpacityDefault 95% — nearly fully opaque

FlowDefault 100%

TaperDefault 11 — long sharp taper at both ends of each stroke

StabilizationDefault 10 — high smoothing for calligraphy-style clean curves

PressureAffects size only (not opacity) — lines vary in weight but stay opaque

Tip: For expressive brush pen feel, raise size to 15–20 px and enable pressure on size. The taper gives strokes a natural start and finish.

Felt Tip Paint

Smooth marker-like brush with soft wetness bleed at edges. Produces clean, even strokes suitable for coloring flats, concept art, and illustration.

Options

SizeDefault 12 px max 60 px

OpacityDefault 90%

FlowDefault 95%

BleedDefault 15 — controls how much wet ink spreads at the stroke edges

TaperDefault 6 — slight start/end taper

StabilizationDefault 8

PressureAffects size only — opacity stays consistent

Marker Paint

Bold marker with slightly ragged edges and wetness bleed. Semi-transparent strokes overlap to create deeper color, mimicking the look of alcohol markers like Copic.

Options

SizeDefault 30 px max 80 px

OpacityDefault 55% — overlapping strokes build up darker color

FlowDefault 90%

BleedDefault 20 — wet edge spread effect

TaperDefault 7

PressureAffects size only

Tip: Use on a dedicated layer at Multiply blend mode for the classic marker-on-paper look where colors compound on top of sketch lines.

Paint Paint

Oil paint simulation with color mixing and wetness. The brush picks up colors already on the canvas and blends them as you paint, simulating physical paint behavior.

Options

SizeDefault 55 px max 200 px

OpacityDefault 100%

MixingDefault 0 — how much canvas color is picked up. Higher = more color blending from existing paint.

Bleed (Wetness)Edge darkening and wet bleed effect on stroke edges

TaperDefault 5 — taper at stroke start and end

StabilizationDefault 10

PressureAffects both size and opacity for a dynamic, expressive feel

Tip: Set Mixing to 30–50% for a blending effect that drags existing colors. Set to 0 for clean opaque strokes. Great for digital oil painting techniques.

Pastel Paint

Soft pastel stick with paper texture and natural opacity variation. Builds up in layers with a chalky matte finish. Opacity and position jitter create the characteristic rough texture of real pastels.

Options

SizeDefault 60 px max 200 px

OpacityDefault 60%

FlowDefault 50% — gradual buildup per stamp

TextureBristol paper at 50% strength — paper grain shows through strokes

Opacity JitterDefault 35% — natural variation in stamp transparency

WetnessDefault 15 — slight wet bleed at edges

PressureAffects both size and opacity

Smudge / Blend Utility

Blends colors that are already on the canvas without adding new color. Simulates finger-smearing wet paint. Higher Mixing values create a stronger drag of existing color.

Options

SizeDefault 30 px max 120 px

OpacityDefault 50%

MixingDefault 70% — controls how aggressively existing color is dragged. Higher = stronger smear.

StabilizationDefault 8

PressureAffects both size and opacity

Eraser Utility

Erases pixels on the active layer. Supports the same brush types and settings as painting tools. Soft eraser for blended edges; hard eraser for clean cuts.

Options

SizeDefault 100 px max 200 px

OpacityDefault 70% — partial erasure preserves underlying paint at reduced opacity

FlowDefault 40% — gradual transparency buildup per stamp

Hardness0 = fully feathered soft edge, 100 = crisp pixel-sharp edge

StabilizationDefault 4

PressureAffects both size and opacity

Soft eraser: Hardness 0, flow 40%, opacity 70% — smooth blended edges.
Hard eraser: Hardness 100, opacity 100% — precise pixel cutout.

Clone Stamp Utility

Samples an area of the canvas and paints it elsewhere. Used for retouching, removing unwanted elements, and duplicating texture regions.

How to Use

Alt + click to set the clone source point (a crosshair appears)
Release Alt, then paint normally — the brush samples from the source
The source offset moves relative to your brush as you stroke

Options

SizeDefault 30 px max 150 px

OpacityDefault 80%

HardnessDefault 20% — soft feathered edge for seamless blending into surroundings

StabilizationDefault 2

Eyedropper Utility

Click anywhere on the canvas to sample that color and set it as the foreground color. Automatically returns to the previously active tool after picking.

Quick access: Hold Alt while using any painting tool to temporarily activate the eyedropper. Release Alt to return to painting immediately.

Shape Tools Shape

Shape tools draw directly onto the active pixel layer using the current foreground color, brush size, and opacity.

╱

LineL

Click and drag to draw a straight line. Hold Shift to snap to 45° angle increments. Stroke width = current brush size.

○

Circle / EllipseC

Click and drag to draw an ellipse. Hold Shift to constrain to a perfect circle. Toggle fill in tool options.

□

RectangleR

Click and drag to draw a rectangle. Hold Shift to constrain to a perfect square. Toggle fill in tool options.

⬡

Polyline—

Click to place vertices one at a time. Press Enter to finalize as a closed filled polygon. Press Escape to cancel.

All shape tools share: default size 4 px, opacity 100%, flow 100%. Change size via brush size controls or [ / ] keys.

Pen Tool (Bezier) Vector

Creates resolution-independent vector paths stored as pen layers. Paths are procedural — re-rendered at any zoom and fully editable at any time. Each pen layer stores anchor points, bezier handles, color, stroke width, and fill state.

When you switch to the Pen tool, a floating options bar appears. Select a drawing sub-mode before starting. The bar stays open until you switch away from the Pen tool.

Options Bar

Color swatchClick to open a color picker and choose the stroke/fill color

Op (Opacity)Layer opacity 1–100. Drag the number field to adjust.

W (Stroke Width)Stroke width in pixels 1–100. Drag the number field to adjust.

S / F toggleS = Stroke only (outline). F = Fill (solid shape, also stroked).

ApplyFinalize the current path and save/update the pen layer

CloseDismiss the options bar (switches away from Pen tool)

Sub-Modes

Pen

Classic bezier pen. Click to add corner anchors. Click-drag to create smooth anchor points with symmetric handles. Click the first anchor to close the path.

Alt + anchor — toggle smooth ↔ corner
Alt + drag handle — break handle symmetry
Shift + click — snap to 45° from previous point
Click on segment — insert anchor at that position

Freehand

Draw a freehand stroke naturally. On release, ComfySketch Pro automatically fits smooth cubic bezier curves through your stroke using Schneider's algorithm. Sub-mode persists so you can keep drawing consecutive strokes.

Rectangle

Drag to create a rectangular closed vector path with four corner anchor points. Hold Shift for a perfect square. Auto-finalizes on release.

Ellipse

Drag to create an elliptical closed path with four smooth bezier anchor points. Hold Shift for a perfect circle. Auto-finalizes on release.

Add Point

Click anywhere on an existing path segment to insert a new anchor using De Casteljau subdivision — preserving the curve shape exactly. You can also drag existing anchors and handles in this mode.

Delete Point

Click an anchor to delete it. Drag to draw a red selection rectangle — all anchors inside are highlighted and deleted on release. Small click = single delete, drag rectangle = batch delete.

Convert Point

Click a smooth anchor to convert it to a corner (removes handles). Click a corner anchor and drag to pull out symmetric handles and convert it to smooth. Also allows dragging existing handles directly.

Auto-enters edit mode when clicking the sub-mode button with an existing pen layer active.
Add Pt / Delete Pt / Convert Pt buttons appear dimmed until a path exists — they unlock automatically after the first path is committed.

Curvature Pen

Click to place anchor points — the path automatically flows through them as smooth curves using Catmull-Rom interpolation. No handle dragging required. Handles are invisible during creation and auto-calculated.

Double-click — place a corner (cusp) point instead of smooth
Shift + click — snap to 45° from previous point
Click first anchor — close the path
Enter — finalize | Escape — cancel

Pen Mode Interactions

Action	Result
Click empty space	Add corner anchor (no handles)
Click + drag	Add smooth anchor with symmetric bezier handles
Click first anchor (≥2 points)	Close the path
`Alt` + click anchor	Toggle smooth ↔ corner (remove or create handles)
`Alt` + drag handle	Break handle symmetry — move one handle independently
`Shift` + click	Snap new anchor to 45° angles from previous
Click segment	Insert new anchor at that point on the curve
Drag corner anchor (no handles)	Pull out symmetric handles (converts to smooth)
`Enter`	Finalize path and create/update pen layer
`Escape`	Cancel current edit / clear path

Re-editing Pen Layers

Double-click a pen layer in the layers panel to re-enter edit mode. All anchors and handles reappear. Apply commits changes; Escape reverts to the original path.

SVG Export / Import

Right-click a pen layer → Export as SVG to download as an .svg file. Use File → Import SVG… to import paths from Inkscape, Illustrator, or Affinity Designer. See the SVG section for full details.

Fill & Gradient

Flood Fill

Click on the canvas to flood-fill a contiguous region of similar color with the foreground color.

Tolerance0–100. Low = only fills near-identical pixels. High = fills broader color ranges including gradients.

Gradient

Click-drag on the canvas to define a gradient from start to end point. Gradients are stored as vector layers and can always be re-edited.

LinearGradient flows along a straight line from the start point to the end point

RadialGradient radiates outward from the start point as a circle

Gradient Editor

Add stopClick anywhere on the gradient bar to add a color stop up to 8 stops

Move stopDrag a stop left or right to reposition it

Change colorClick the color swatch on a stop to open the color picker

Delete stopRight-click a stop to remove it

Re-edit: Select the Fill tool (G) and click an existing gradient layer to reopen the editor — change stops, colors, and drag the gradient direction handles.

Fill Shortcuts

Shortcut	Action
`Alt`+`Delete`	Fill selection (or entire layer) with foreground color
`Ctrl`+`Delete`	Fill selection (or entire layer) with background color

Selection Tools Select

Selections define an active region. Painting, filling, and transforms affect only the selected area. Multiple selection modes can be combined using Shift/Alt modifiers.

▭

Rectangle SelectM

Click and drag to define a rectangular selection. Hold Shift while dragging to constrain to a perfect square.

◯

Ellipse Select⇧M

Click and drag for an elliptical selection. Hold Shift to constrain to a perfect circle.

⌖

Lasso—

Draw a freehand closed boundary around the area you want to select. Release to close the selection automatically.

⬡

Polyline Select—

Click to place polygon vertices. Press Enter to finalize (minimum 3 points). Press Escape to cancel. Creates a precise polygonal selection.

🖌

Brush Select—

Paint a selection mask with a soft or hard brush. Paint to add, Alt+paint to erase from the mask. Press Enter to convert the painted mask to a selection.

SizeDefault 50 px brush

HardnessDefault 80% — adjusts edge feathering

🪄

Magic WandW

Click to select a contiguous region of similar color. Shift+click adds more regions to the existing selection.

Tolerance0 = exact match only. 100 = selects almost everything.

Selection Modifiers (while drawing)

Modifier	Effect
`Shift` + drag	Add to existing selection
`Alt` + drag	Subtract from selection

Selection Operations

Shortcut	Action
`Ctrl`+`A`	Select entire canvas
`Ctrl`+`D`	Deselect all
`Ctrl`+`Shift`+`I`	Invert selection
`Ctrl`+`J`	Copy selected area to a new layer
`Ctrl`+`Shift`+`J`	Cut selected area to a new layer
`Delete`	Clear (erase) the selected area on the active layer
`Alt`+`Delete`	Fill selected area with foreground color
`Ctrl`+`Delete`	Fill selected area with background color

Selection Refinements (tool properties)

GrowExpand selection boundary outward by N pixels

ShrinkContract selection boundary inward by N pixels

FeatherBlur the selection edge for a soft, gradual transition

Move / Transform Utility

Moves and transforms any layer non-destructively. A live preview shows changes before committing. Works on pixel layers, text layers, gradient layers, and pen layers.

Transform Handles

Center dragReposition the layer

Edge handlesScale in one axis only (stretches)

Corner handlesScale freely. Hold Shift for proportional scaling.

Outside cornersRotate. Hold Shift to snap to 15° increments.

Ctrl + cornerFree distort / perspective warp (pixel layers only)

Commit & Cancel

Action	Result
`Enter` or double-click inside	Commit the transform and apply permanently
`Escape`	Cancel — reverts to original position and size
`Alt` + click (no active transform)	Duplicate the layer then enter move mode on the copy

Auto-Select

Double-click the Move tool button in the toolbar to open Move Options. Enable Auto-select to automatically pick the topmost layer with visible content under the cursor when clicking — no manual layer selection required.

Multi-Layer Transform

Select multiple layers using Ctrl+click or Shift+click in the Layers panel, then use the Move tool. All selected layers transform together. Click a group header to select and transform all children simultaneously.

Crop Tool Utility

Photoshop-style crop with adjustable handles. When you switch to the Crop tool, crop handles appear over the full canvas immediately. Drag handles to define the crop area. A rule-of-thirds grid overlays while dragging.

How to Use

Press H or click the Crop button in the toolbar
Drag any of the 8 edge/corner handles to define the crop region
Drag inside the crop area to reposition the frame (or drag the underlying image)
Press Enter or double-click inside the frame to apply the crop
Press Escape or switch tools to cancel

Features

Rule of thirdsGrid lines appear while dragging handles to help with composition

Canvas expansionDrag handles outside the canvas bounds to expand the canvas size (new areas are transparent)

Content previewExisting off-canvas content (overflow) is shown as a checkerboard preview while crop is active

Edge snappingHandles snap to the edges of visible layer content

W/H inputsNumeric width and height inputs in the confirm bar — type exact pixel values

Tip: To add canvas space on one side without cropping, drag a handle beyond the canvas edge. The expansion area is shown with a checkerboard pattern.

Text Tool Vector

⇧X

Click anywhere on the canvas to place a new editable text layer. A floating options bar appears with full typographic controls. Text remains vector/editable as long as it hasn't been rasterized.

Text Properties

Font FamilyAny system-installed font

Font Size1–999 px

Bold / ItalicToggle standard weight and style

UnderlineAdd underline decoration

ColorText color — can be applied per-character (see below)

AlignmentLeft, Center, or Right

Line Height0.5× – 3.0× multiplier

Letter Spacing−50 to +50 px

Per-Character Formatting

Select a range of characters inside the text overlay using click-drag, then change the color or size in the options bar. Only the selected characters are affected — the rest of the text is unchanged.

Committing & Re-editing

CommitSwitch tools or click outside the text overlay

Re-editSwitch to Text tool and click an existing text layer

TransformUse Move tool (V) to non-destructively rotate, scale, and position text

3D Layers

ComfySketch Pro supports 3D model layers powered by Three.js. Drop a 3D model file onto the canvas to add it as a 3D layer, then enter 3D Mode to pose, light, and snapshot it.

Supported Formats

GLB

GLTF

OBJ

FBX

Adding a 3D Layer

Drag and drop a 3D model file anywhere onto the canvas
A new 3D layer appears with an orange border thumbnail in the layers panel
Double-click the 3D layer to enter 3D Mode

3D Mode

In 3D mode the 3D viewer panel becomes active. All other layers are dimmed. You can:

OrbitLeft-drag in the viewer to rotate the camera around the model

PanMiddle-drag or right-drag to pan the camera

ZoomScroll wheel to zoom in/out

SnapshotClick Snapshot to render the current 3D view as a flat pixel layer on top of the canvas. By default, ambient occlusion (AO) is baked into the snapshot. Enable Snapshot without AO in Settings to capture a clean render without AO — useful for compositing.

AnimationIf the model has animations, use the timeline panel to play and scrub clips

ExitClick Exit 3D or press Escape to leave 3D mode

Limit: Maximum 4 active 3D layers per canvas. 3D layers are always placed below raster paint layers in the stack.

Pie Menu

Right-click anywhere on the canvas to open the radial pie menu — a quick tool switcher with a mini color wheel in the center. No need to reach for the toolbar.

Pie Menu Tools

Felt Tip (B)

Paint (A)

Pastel (Y)

Smudge (F)

Eraser (E)

Pencil (P)

Center Color Wheel

The center of the pie menu contains a mini HSV color wheel — hue ring + saturation/value triangle. Change your color without opening the full color panel.

Usage

OpenRight-click anywhere on the canvas

Select toolClick any tool icon in the ring — the menu closes and the tool activates

Pick colorClick or drag inside the center color wheel

CloseClick outside the ring, press Escape, or right-click again

Brush Types

Every painting tool uses one of these underlying brush rendering engines. Change it in a tool's properties panel (double-click the tool button).

Type	Description
Round	Hard-edged circle. Hardness controls how sharply the edge falls off (0 = soft feather, 100 = crisp).
Soft	Gaussian radial falloff from center to edge — classic soft-glow or airbrush look.
Airbrush	Wide soft spray with flow-based buildup. Color accumulates while held in one position.
Spray	Scattered random dots. Density controls particles per stamp. Creates stipple and splatter effects.
Marker	Flat chisel-shaped stamp. Rotating the brush angle changes apparent width.
Ragged	Irregular rough edges — ideal for dry brush, charcoal, and textured painting effects.
Alpha	Custom grayscale tip image (pencil grain, pastel texture, eraser shape). White = full paint, black = no paint. Auto-inverted if average brightness > 50%.

Round / Soft Shape Controls

Hardness0–100. Sharpness of the brush edge. 100 = fully crisp, 0 = fully feathered Gaussian.

Roundness100 = circle. Lower values flatten the brush into an ellipse.

AngleRotation of an elliptical brush tip (0–360°).

Pressure Sensitivity

When a pen tablet is connected, stylus pressure data modulates the brush dynamically on every stroke.

Affects SizeLight pressure = smaller brush. Full pressure = maximum size.

Affects OpacityLight pressure = more transparent. Full pressure = full opacity. Minimum 15% at zero pressure (prevents invisible strokes).

Pressure Curves

Curve	Feel
Linear	Direct 1:1 mapping — pressure value directly becomes size/opacity
Soft	Very sensitive at low pressure — a light touch gives a bigger response than expected
Firm	Requires more force — small response until mid-pressure range
S-Curve	Gentle at both low and high extremes, steepest in the middle range

Stabilization (Smoothing)

Smooths out shaky hand movements using a lazy brush algorithm — the brush tip lags behind the physical cursor, filtering out tremor while preserving intentional movements.

Range0–20. 0 = no lag (raw input). 20 = maximum smoothing with noticeable lag.

Default14 globally — varies per tool (Ink=10, Pencil=6, Pastel=6, Clone=2)

Accessible via the smoothing icon in the top options bar, or inside any tool's properties panel.

Texture

Textures add surface variation to brush strokes. The texture alpha map is multiplied into each brush stamp, simulating painting on different paper and canvas surfaces.

Procedural Textures

Name	Character
None	No texture applied
Hot Press	Very smooth — subtle micro-fiber grain (watercolor hot-press paper)
Cold Press	Prominent bumpy grain with peaks and valleys
Canvas	Regular woven grid pattern — linen/cotton canvas
Bristol	Nearly invisible fine grain — default for pencil and pastel
Kraft	Medium irregular fibrous texture — brown kraft paper
Rough	Heavy tooth, chunky irregular grain — rough sketch paper

Image Textures (512×512)

Watercolor

Wash

Splatter

Grunge

Stipple

Wrinkle

Concrete

Stone

Blot

Decay

Texture Strength0–100%. 0 = no texture visible. 100 = texture fully dominates the stamp shape.

Jitter

Jitter adds controlled randomness to brush stamps, creating organic natural-looking variation along a stroke.

Size JitterRandom variation in brush diameter per stamp. 0 = uniform, 1 = maximum random range.

Position JitterRandom offset from the stroke path per stamp. Creates scatter/spread effects.

Opacity JitterRandom per-stamp transparency variation. Creates natural fade and density fluctuation.

Rotation JitterRandom rotation of each stamp. Most visible with alpha tips like pencil and pastel.

Brush Library

Browse, load, and save brush presets. Press J to open the brush library panel. Presets are stored in browser IndexedDB and persist across sessions.

Built-in Preset Categories

Category	Count	Includes
Dry	9	Soft/Hard/Oil Pastel, Chalk, Soft/Vine/Compressed/Hard Charcoal, Conte
Paint	12	Round/Flat/Spray/Oil Brush, Wet Acrylic, Turpentine, Palette Knife, Impasto, Wash, Gouache, Watercolor
Ink	11	Fine Ink, Brush Pen, Technical Pen, Felt Tip, Chisel Tip, Fine Liner, Felt Nib, Marker, Copic Broad, Copic Brush, Highlighter
Pencil	10	8B, 5B, 2B, B, HB, 3H, 6H, Technical, Colored, Sketch
Utility	7	Soft Blend, Smudge, Finger Paint, Wet Paint, Dry Brush, Soft Eraser, Hard Eraser

Save custom presets: Configure any brush the way you want, then click Save in the library panel to store it as a named preset for later reuse.

Layer Panel

Layers are stacked top-to-bottom in the panel — the topmost layer is drawn on top. Click to select. All painting operations affect the active layer only.

Layer Controls

Opacity slider0–100% — controls the layer's transparency in the composite

Blend modeDropdown with 16 composite blend modes (see Blend Modes section)

Eye iconToggle visibility without deleting

Lock iconLock layer to prevent accidental painting (available on raster layers)

AddCreate new empty pixel layer above the active layer

DeleteRemove the active layer (undoable)

DuplicateCopy the active layer and place the copy directly above it

Merge DownFlatten the active layer into the layer below. Shortcut: Ctrl+E

Merge VisibleFlatten all visible layers into one. Shortcut: Ctrl+Shift+E

GroupWrap selected layers into a folder. Shortcut: Ctrl+Shift+G

RenameDouble-click the layer name to rename it

Multi-Select

Shift+clickRange-select from the active layer to the clicked layer

Ctrl+clickToggle individual layers in/out of the selection

Reorder

Drag layers up or down to reorder. Drag a layer onto a group header to nest it inside the group.

Right-Click Context Menu

Right-click any layer for additional options: Rename, Duplicate, Merge Down, Merge Visible, Move to Group, Set as Mask, Ungroup, Rasterize, and (for pen layers) Export as SVG.

Layer Types

🖼

Pixel / Raster

Standard bitmap layer. Created by default. Receives all painting, erasing, and filter operations. Content is resolution-dependent.

Text

Editable text stored as vector data. Rendered on-the-fly at any zoom. Re-editable at any time. Non-destructively transformable with the Move tool.

Rasterize: Right-click the layer → Rasterize Layer, or switch to a paint tool and click the canvas — a confirmation dialog will appear before converting to pixels.

▦

Gradient

Vector gradient fill. Color stops and direction are editable at any time by selecting the Fill tool and clicking the gradient layer.

✒

Pen (Bezier)

Vector bezier path. Stores anchor points, handles, color, width, and fill. Double-click in the layers panel to re-edit. Exportable as SVG.

Rasterize: Right-click the layer → Rasterize Layer, or switch to a paint tool and click the canvas — a confirmation dialog will appear before converting to pixels.

📦

Container for a 3D model (GLB/GLTF/OBJ/FBX). Double-click to enter 3D mode. Always placed at the bottom of the layer stack. Snapshot creates a flat pixel layer from the current 3D view.

Blend Modes

Controls how a layer's colors interact with the layers beneath it.

Mode	Effect
Normal	Standard alpha compositing. Replaces what's below at the layer's opacity.
Multiply	Darkens. Multiplies layer color with layers below. White = transparent, black stays black.
Screen	Lightens. Inverted multiply. Black = transparent, white stays white.
Overlay	Contrast boost. Multiplies darks, screens lights. Intensifies the image below.
Darken	Keeps only the darkest pixel between this layer and the layers below, per channel.
Lighten	Keeps only the lightest pixel between this layer and the layers below, per channel.
Color Dodge	Brightens the lower layer based on this layer's brightness. Creates vivid highlights.
Color Burn	Darkens the lower layer. Deepens shadows and increases saturation.
Hard Light	Strong Multiply or Screen depending on upper layer brightness. High contrast.
Soft Light	Subtle dodge/burn effect. Gentle lighting and shading.
Difference	Inverts lower layer where upper is white. No change where upper is black.
Exclusion	Similar to Difference but lower contrast and softer.
Hue	Applies the hue of this layer while keeping the saturation and luminance below.
Saturation	Applies the saturation of this layer to the colors below.
Color	Applies hue + saturation. Useful for colorizing grayscale artwork.
Luminosity	Applies the brightness of this layer to the hue and saturation below.

Groups

Groups (folder layers) organize layers and enable transforming multiple layers as a single unit.

CreateSelect multiple layers, then click the Group button or press Ctrl+Shift+G

Expand / CollapseClick the arrow toggle on the group header

Group opacityOpacity and blend mode on the group header affect all children together as a unit

UngroupRight-click the group header → Ungroup — children move to the parent level

Move entire groupClick the group header to select all children, then use the Move tool

Nest layersDrag any layer onto a group header to add it to the group

Mask Layer

One layer can be designated as the output mask. This layer's content is exported through the node's mask output as a float32 grayscale tensor.

Set maskRight-click any layer → "Set as Mask Layer"

White = 1.0Painted/active areas — full mask value

Black = 0.0Transparent/empty areas — no mask

Export maskFile → Export Mask PNG — saves the mask as a standalone PNG

Workflow use: Connect the mask output to inpainting nodes, ControlNet mask inputs, or any ComfyUI node that accepts a mask tensor. The mask layer is output live whenever the node runs.

Color Wheel

Click the foreground color swatch to open the full HSV color wheel panel.

Outer hue ringDrag to select hue (0–360°)

Inner triangleHorizontal = saturation, vertical = value (brightness). Click or drag to pick.

Hex inputType a 6-digit hex code directly and press Enter

Foreground / Background

XSwap foreground and background colors

DReset to defaults: white foreground, black background

Click swatchClick either the foreground or background swatch to choose which one is being edited in the color wheel

Mini Color Wheel (Pie Menu)

Right-clicking the canvas also opens a mini color wheel in the center of the pie menu, allowing quick color changes without opening the full panel.

Palettes & Swatches

Press Q to toggle the floating swatch panel. Pick saved colors quickly or manage custom palettes.

Built-in Palettes

Material

Web Colors

Pastels

Vibrant

Grayscale

Create custom palettes, add the current foreground color to any palette, and reorder or delete saved swatches. Palettes persist across sessions.

Zoom, Pan & Rotate

Action	Input
Zoom in/out	Scroll wheel
Fine zoom	`Alt` + scroll
Zoom in (stepped)	`+` or `=`
Zoom out (stepped)	`-` or `_`
Reset to 100%	`0`
Fit to view	Fit button in toolbar (scales canvas to fill the window)
Pan	Middle mouse button drag
Rotate canvas (smooth)	`Shift` + scroll wheel
Rotate canvas ±15°	`Alt`+`←` / `Alt`+`→`
Reset rotation	`0` (also resets zoom to 100%)

Canvas rotation is view-only — it does not transform pixel data. Use it to draw at a comfortable angle, then press 0 to reset. The rotation indicator appears in the corner when active.

Flip Canvas

The toolbar includes Flip H and Flip V buttons to horizontally or vertically flip the entire canvas (all layers). Useful for checking composition balance and spotting drawing errors.

Mirror Drawing

Toggle horizontal and/or vertical mirror drawing from the toolbar. Every brush stroke is automatically mirrored in real-time across the axis. Dashed guide lines show the mirror axis while active.

Mirror HReflects strokes left ↔ right across the vertical center axis

Mirror VReflects strokes top ↔ bottom across the horizontal center axis

Both4-way symmetry — stroke is copied to all four quadrants simultaneously

Use cases: Symmetrical portraits, character faces, mandalas, logos, and any design that benefits from bilateral symmetry. Disable to break symmetry for fine-tuning details.

Quick Generate (AI)

Ctrl+Enter

The Quick Gen tab provides direct text-to-image generation without needing to wire up a full ComfyUI workflow. It builds a minimal SD pipeline internally and submits it to ComfyUI's API.

How to Use

Open the Run panel on the right and switch to the Quick Gen tab
Type your prompt in the text area
Optionally click the gear icon to open settings (model, LoRA, negative prompt, RMBG)
Click Run or press Ctrl+Enter
Result appears in the preview panel

Settings (Gear Icon)

ModelSelect any checkpoint from your ComfyUI models folder

LoRAOptional LoRA model to apply. LCM LoRAs are sorted to the top of the list.

Negative promptWords and phrases to avoid in the generation

Remove BG (RMBG)Automatically remove background after generation. Requires the RMBG node to be installed. Shown as a checkerboard icon button when available.

Fixed Generation Parameters

Resolution512 × 512

Steps5 (LCM sampler — very fast)

CFG scale2.0

Node Outputs

Output	Format	Description
image	(1, H, W, 3) float32	All visible layers composited as a flat RGB image tensor
mask	(1, H, W) float32	The designated mask layer as grayscale. White=1.0, black=0.0.

Connect image to any image input in your workflow. Connect mask to inpainting, ControlNet, or any node accepting a ComfyUI mask tensor.

SVG Import / Export

Export a Pen Layer as SVG

Right-click the pen layer in the layers panel
Click Export as SVG — an .svg file is downloaded named after the layer

Import an SVG File

Go to File → Import SVG…
Select an .svg file
Each subpath (M…Z block) becomes a separate pen layer inserted above the active layer

Compatible Apps

Inkscape

Adobe Illustrator

Affinity Designer

Any SVG editor

Supported SVG Features

Path commandsM L H V C S Q T A Z — all absolute and relative variants

Style resolutionCSS class blocks, inline style attributes, and presentation attributes (highest priority)

ScalingAutomatically scaled from SVG viewBox to canvas dimensions

Properties importedstroke color, stroke-width, fill, opacity

Limitations: Only <path> elements are imported. Groups, transforms, text, images, and rect/circle primitives are not supported.

File Operations

File Menu (toolbar folder icon)

Item	Description
New Canvas	Create a fresh empty canvas at the current size
Clear Canvas	Erase all content on the current canvas
Open Image…	Open an image file as a new canvas (replaces current)
Open from Input Image	Load the image connected to the node's input as a new canvas
Open Project (.csk)…	Load a saved .csk project file (restores all layers, text, pens, groups)
Open PSD…	Open a Photoshop PSD file as a new canvas with preserved layers
Open ORA…	Open an OpenRaster .ora file as a new canvas
Import Image…	Add an image file as a new pixel layer on the current canvas
Import from Input	Add the node's input image as a new layer
Import PSD Layers…	Import layers from a PSD file into the current canvas
Import ORA Layers…	Import layers from an ORA file into the current canvas
Import SVG…	Import SVG paths as pen layers
Save PNG	Export all visible layers as a flat PNG `Ctrl`+`S`
Save PSD (layers)	Export the full layer stack as a Photoshop PSD file
Save ORA (layers)	Export the full layer stack as an OpenRaster .ora file
Save Project (.csk)	Save full project with all layer data `Ctrl`+`Shift`+`S`
Export Mask PNG	Export the mask layer as a standalone grayscale PNG
Close	Exit the fullscreen editor

Clipboard

Ctrl+CCopy the current selection (or entire layer if no selection) to the clipboard

Ctrl+VPaste clipboard content as a new layer

Auto-Save

Canvas data is continuously auto-saved to browser IndexedDB after every change (debounced 300ms). If the browser crashes, your work is automatically recovered on the next load.

.csk format: ComfySketch Pro project files are ORA-compatible ZIP archives. Renaming to .ora allows opening in other ORA-supporting apps, though vector layers (text, gradient, pen) are stored as ComfySketch Pro-specific data.

Settings

Access via the ⚙ settings button in the toolbar.

Theme

Light

Dark

Studio

Theme choice is saved and restored automatically across sessions.

Preferences

Remember tool settingsSave and restore per-tool brush settings (size, opacity, flow, etc.) between sessions

Show size widgetToggle the floating size/opacity indicator near the cursor during painting

Browser fullscreenAuto-enter browser native fullscreen mode when opening the editor

Undo steps10–100 undo history steps. Default 30. More steps use more memory.

Import / Export Settings

Export all preferences as a JSON backup file. Import to restore settings on another machine. A Reset to Defaults option returns all preferences to factory values.

Hotkeys Reference

Click the ? button in the toolbar (or settings panel) to open the full interactive hotkeys overlay with all keyboard shortcuts listed by category.

Help Menu

The ? toolbar button opens a dropdown with the following items:

ManualOpens this manual in a new browser tab.

Keyboard ShortcutsOpens the interactive hotkeys overlay inside the editor.

About / LicenseShows the ComfySketch Pro commercial license notice and third-party component attributions.

For purchase, support, or bug reports see the Contact & Support section.

Keyboard Shortcuts

Tools

Key	Tool
`B`	Felt Tip
`A`	Paint
`N`	Ink
`P`	Pencil
`K`	Marker
`Y`	Pastel
`F`	Smudge / Blend
`E`	Eraser
`T`	Clone Stamp
`G`	Fill / Gradient
`I`	Eyedropper
`V`	Move / Transform
`H`	Crop
`L`	Line
`C`	Circle / Ellipse
`R`	Rectangle
`U`	Pen (Bezier)
`M`	Rectangle Select
`⇧M`	Ellipse Select
`W`	Magic Wand
`⇧X`	Text
`/`	Toggle previous tool

View & Canvas

Key	Action
`+` / `=`	Zoom in
`-` / `_`	Zoom out
`0`	Reset view (100%, no rotation)
`Alt`+`←`/`→`	Rotate canvas ±15°
`⇧`+Wheel	Smooth canvas rotation
Middle drag	Pan canvas
`Space`	Toggle all UI panels

Brush

Key	Action
`[`	Smaller brush
`]`	Larger brush
`S`+drag	Interactive size adjust
`O`+drag	Interactive opacity adjust
`Alt`+click	Pick color (eyedropper)

Color

Key	Action
`X`	Swap foreground/background
`D`	Reset to white/black
`Q`	Toggle floating swatches

Edit

Key	Action
`Ctrl`+`Z`	Undo
`Ctrl`+`Y`	Redo
`Ctrl`+`A`	Select all
`Ctrl`+`D`	Deselect
`Ctrl`+`⇧I`	Invert selection
`Ctrl`+`C`	Copy to clipboard
`Ctrl`+`V`	Paste from clipboard
`Ctrl`+`J`	Copy selection → new layer
`Ctrl`+`⇧J`	Cut selection → new layer
`Ctrl`+`E`	Merge down
`Ctrl`+`⇧E`	Merge visible
`Ctrl`+`⇧G`	Group selected layers
`Delete`	Clear selection
`Alt`+`Delete`	Fill with FG color
`Ctrl`+`Delete`	Fill with BG color

File

Key	Action
`Ctrl`+`S`	Save PNG
`Ctrl`+`⇧S`	Save project (.csk)
`Ctrl`+`Enter`	Run workflow / Quick Gen

Transform

Key	Action
`Enter`	Commit transform
`Esc`	Cancel / deselect
`⇧`+rotate handle	Snap to 15° increments
`Ctrl`+corner handle	Free distort (pixel layers)

Other

Key	Action
Right-click canvas	Open pie menu
`J`	Toggle brush library
`	Toggle size/opacity widget

↑ Back to top

Contact & Support

Have a question, found a bug, or want to share your work? Reach out through any of the channels below.

Purchase mexesmith.gumroad.com — license & downloads

Email mexes1978@live.com

LinkedIn Vitor Silva

Bug reports & feature requests: Use the GitHub repository issues page for technical bugs and suggestions. For licensing questions, email directly.

↑ Back to top