Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-Darkroom

ComfyUI Extension: ComfyUI-Darkroom

Repo Name

ComfyUI-Darkroom

Author
jeremielouvaert (Account age: 5084 days)
Nodes
View all nodes(2)
Latest Updated
2026-10-05
Github Stars
0.13K

How to Install ComfyUI-Darkroom

Install this extension via the ComfyUI Manager by searching for ComfyUI-Darkroom
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-Darkroom in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

ComfyUI-Darkroom Description

ComfyUI-Darkroom adds 59 image-finishing nodes for film looks, color grading, reference matching, lens correction, RAW processing, exposure checks, reusable LUTs, and CMYK print preparation.

ComfyUI-Darkroom Introduction

ComfyUI-Darkroom preview

ComfyUI-Darkroom is a collection of 59 ComfyUI nodes for finishing images. You can use it to give AI-generated artwork the character of photographic film, make precise color adjustments, correct lens effects, match the colors of a reference image, inspect exposure and saturation, or prepare an image for CMYK printing.

The collection includes 161 color and black-and-white film stocks, 35 spectral film-and-print looks, and 102 lens profiles. Its processing runs locally, with no API key or per-image API cost. The nodes are organized under AKURATE/Darkroom/ in ComfyUI.

You do not need to use every tool at once. For example, you might add a film stock and grain to make a generated portrait feel photographic, use a reference image to bring a series of artworks closer to the same palette, or soft-proof an illustration before sending it to a printer.

How ComfyUI-Darkroom Works

Think of Darkroom as a digital finishing desk. You connect an image to a sequence of nodes, and each node makes one kind of change. A simple photographic-look workflow might be:

Image → White Balance → Film Stock (Color) → Halation → Film Grain → Preview

White Balance removes an unwanted color cast. Film Stock (Color) sets the overall palette and tone. Halation adds a film-like effect around bright areas, and Film Grain adds texture. You can preview the result and adjust each stage separately instead of trying to create the entire look with one setting.

Most nodes offer presets for a quick starting point, controls for fine-tuning, and a strength setting that blends the result with the original image. Darkroom also handles batches of images. The author's processing approach generally works in linear light—a way of calculating light and color that helps effects such as exposure and halation behave more like real light rather than a flat colored overlay.

Darkroom separates two kinds of edits:

  • Color-only edits change a pixel's color without needing to inspect its neighbors. Examples include a tone curve, a color balance adjustment, or a film-stock color look. These can be exported as reusable .cube LUTs.
  • Spatial edits depend on where pixels are or what surrounds them. Grain, scratches, lens distortion, sharpening, and light leaks are examples. They can finish your image, but they cannot be faithfully stored in a color LUT.

You can use the tools with AI-generated images. If you also work with camera photos, Darkroom includes RAW-file processing and camera-profile support.

ComfyUI-Darkroom Features

Film looks and photographic texture

The film nodes let you build a look in layers rather than relying on a single filter:

NodeWhat it lets you do
Film Stock (Color)Choose from 111 color stocks, including looks associated with Kodak Portra, Ektar, Fuji Velvia and Superia, CineStill, Kodachrome, Vision3, and Polaroid. Adjust the result with a freeform tone curve and contrast, shadow, midtone, and highlight controls.
Film Stock (B&W)Choose from 50 black-and-white stocks, including Ilford HP5+, Kodak Tri-X, T-MAX, and pushed variants.
Film Grain / Film Grain ProAdd film-like texture. The standard node varies grain with brightness and ISO; Pro offers more control over grain size, variation, and color grain while keeping its appearance consistent across resolutions.
HalationAdd the characteristic spread of light around highlights. Presets include CineStill 800T, subtler Vision3, and black-and-white plate looks; an anti-halation control and Custom preset offer further adjustment.
Print StockSimulate the tonal and color contribution of photographic paper in a negative-to-print workflow.
Cross ProcessRe-create color shifts associated with developing slide film in color-negative chemistry, or the reverse.
Spectral B&W (Ortho/Pan)Convert color to black and white using film-like sensitivity to different colors. An orthochromatic setting makes reds darker; a panchromatic setting gives a more natural balance. These are approximations because an ordinary RGB image does not contain the full spectrum of a real scene.
Reciprocity FailureAdd the color shifts and shadow changes associated with very long film exposures. Choose a supported stock and exposure time to explore different long-exposure characters.
SabattierCreate partial tonal reversal, particularly in highlights, for an experimental darkroom look.
Adjacency AcutanceAdd film-development edge effects for a different sense of definition from ordinary digital sharpening. Optional bromide drag introduces directional streaking.

For a convincing film finish, try a stock first, then add grain or halation only as needed. For a more distressed image, add one of these procedural effects:

  • Film Rebate places your image in a larger canvas with a film or print border. Formats include 35mm, 120, 4×5 sheet film, Polaroid-style integral film, and slide mounts. Fill and fit modes help when the image and border have different shapes. It also outputs a mask showing where your image sits.
  • Light Leak adds stray-light exposure along an edge, through a sprocket area, or from a pinhole. It outputs a mask so you can reuse or control the affected area.
  • Film Damage creates seeded dust, hairs, and scratches without relying on fixed overlay images. You can control the kind of damage and receive a mask for restoration or inpainting work.

Color correction and grading

If an artwork feels too cool, flat, saturated, or inconsistent with a series, you can make broad corrections first and then target particular colors.

Tool or groupUse it when you want to…
White Balance / Auto White BalanceCorrect a color cast manually using temperature and tint, or let the automatic node estimate a correction. Auto White Balance offers four methods and a strength control.
Exposure & ToneBrighten or darken an image and shape its contrast, shadows, highlights, whites, and blacks.
HSL SelectiveAdjust hue, saturation, and brightness within eight color bands—for example, changing foliage without changing the entire image.
VibranceLift muted colors while protecting colors that are already strong and reducing the impact on skin tones.
Clarity / Texture / DehazeIncrease local contrast, bring out surface detail, or reduce a hazy appearance.
Sharpening Pro / Noise ReductionRefine detail or smooth unwanted noise. Sharpening offers radius, amount, threshold, and edge masking; Noise Reduction includes seven presets.
Skin Tone UniformityGently even skin color with a mask-weighted adjustment while preserving texture. It has six skin-type presets.
Color QualifierSelect a color range and apply one of 19 selection-and-correction actions.

For creative grading, Tone Curve offers channel-specific curves and presets such as faded blacks and matte film. Lift Gamma Gain, Log Wheels, and 3-Way Color Balance let you work separately on darker, middle, and brighter tones. OkLab Color provides lightness, contrast, chroma, hue, and tint controls designed to keep adjustments perceptually even across colors.

More targeted nodes include Hue vs Hue, Hue vs Sat, Lum vs Sat, Sat vs Sat, and Color Warper. For example, you can shift the hue of a sky, reduce saturation in highlights, or tame colors that are already too vivid. Each offers presets or region-based controls to help you start.

Match a reference image

Color Match (Reference) moves the colors of your target image toward the color distribution of a reference image. This is useful when you have a mood-board image or want several pieces to share a palette. Its intensity control lets you keep some of your original color.

The node offers four methods:

  • Reinhard: a fast, straightforward starting point.
  • Wasserstein: useful for more complex color distributions.
  • Forgy: matches color palettes using grouped colors.
  • Kantorovich: another color-transfer approach; it requires the optional POT package.

Matching a color distribution is not the same as copying the reference's composition or lighting. Check the result on your own subject and reduce intensity if the transfer is too strong. The methods are adapted from gradia.

Lens, motion, and water effects

Chromatic Aberration, Vignette, and Lens Distortion can create or correct optical characteristics such as colored edge fringing, darkened corners, and barrel or pincushion distortion. Perspective Correct helps straighten keystoned architectural images. Lens Profile combines distortion, aberration, and vignette adjustments using one of 102 lens models.

Several lens and optics nodes accept a mask. A mask tells the node where to apply an effect, including partially: you could leave a subject relatively untouched while changing the surroundings.

Long Exposure simulates a handheld camera gathering light across a moving path. Rather than applying a single directional blur, it can produce the doubled edges and changing motion associated with camera movement. Its optional mask can keep part of an image still while another part moves.

Water Refraction bends an image as though viewed through water on a surface. Controls include the viewed area's physical width, water volume, sweep, and settling time. The field_width_mm control is especially important: framing a small area of roughly 20–50 mm produces a more visible macro effect than framing an entire screen. This node is comparatively slow—about 45 seconds at 1024 resolution according to the author's description—and can output a mask showing where fine grain was lost through the warp.

RAW images and camera looks

RAW Load opens supported camera RAW formats, including .cr3, .nef, .arw, .raf, and .dng. You can choose processing options such as white balance, highlight handling, output color space, and a Camera Look. It outputs both an image and camera information. RAW Metadata Split makes details such as camera, lens, ISO, aperture, and shutter speed available to other nodes.

Camera Looks use Adobe .dcp profiles when available. Darkroom looks for profiles in ComfyUI/models/camera_profiles/, in its reserved bundled-profile location, and in supported Adobe Camera Raw or Lightroom locations on the same machine. Profiles must suit the detected camera body. If a selected look is unavailable for that body, RAW Load falls back to Adobe Standard and prints a warning in the console.

For Fujifilm camera users, the author's documentation points to FujifilmCameraProfiles as a source for building certain color-simulation DCPs. The author's separate black-and-white DCP builder produces approximations, not calibrated matches to the camera's in-camera rendering. These camera-profile options matter only when you are working with compatible RAW photographs; they are not needed to grade an AI-generated image.

Scopes and print preparation

Histogram shows how brightness or individual color channels are distributed, including warnings at the darkest and brightest ends. Vectorscope shows color direction and saturation. These visual guides can help you check a grade when a monitor—or your eyes after a long session—makes it hard to judge small changes. Connect their image outputs to a Preview Image node.

For print projects, Darkroom provides a separate CMYK workflow:

  1. CMYK Soft-Proof previews the color change expected when converting from screen-oriented RGB to a chosen print profile.
  2. CMYK Gamut Warning identifies colors the selected printing condition may not reproduce accurately.
  3. CMYK TAC Check flags areas with too much combined ink coverage. Presets cover coated, uncoated, web-coated, and newsprint conditions, with a custom option.
  4. CMYK Export TIFF writes a four-channel CMYK TIFF with an embedded ICC profile and configurable DPI.

The CMYK nodes can find profiles in Darkroom's data/icc_profiles/ folder and the operating system's profile store. Additional profiles are available from ECI's downloads (https://www.eci.org/doku.php?id=en:downloads). For photographs, the default perceptual rendering intent is a starting point; the other intents serve different proofing or graphic-design needs. Confirm the required profile and ink limits with your printer before exporting.

Halftone is a separate stylizing node for ink-dot looks such as comics or newsprint. It offers dot shapes, screening methods, monochrome or color output, and a strength blend. It is not a calibrated substitute for CMYK Soft-Proof.

Reusable LUTs and color management

A .cube LUT is a reusable color recipe. LUT Apply (.cube) imports a compatible LUT and provides a strength control. LUT Export (.cube) saves a Darkroom color grade for use in software that supports 3D LUTs, including DaVinci Resolve, Premiere Pro, Photoshop, Capture One, and Final Cut Pro.

To preview a grade and export its LUT in one workflow, use:

Photo + LUT Identity Generator → LUT Bake Inject → color-only grading nodes → LUT Bake Extract

Connect the extracted graded photo to a preview or image-saving node, and the graded lattice and LUT size to LUT Export. The identity generator offers lattice sizes of 17, 33, and 65. The example LUT bake and apply workflow shows the connections in ComfyUI.

Keep the nodes between Inject and Extract color-only. Tone Curve, Film Stock, HSL Selective, color wheels, and similar per-pixel adjustments are appropriate. Grain, halation, light leaks, sharpening, lens effects, and other edits that depend on image position or neighboring pixels are not. Apply those spatial effects to the graded photo after Extract.

Color Space Transform converts between sRGB, Linear sRGB, ACEScg, ACEScct, Rec.2020, and DCI-P3. ACES Tonemap offers several ways to bring a wide range of brightness into a displayable image, including ACES Filmic, ACES Fitted, AgX, Reinhard, and Filmic. If you do not have a specific color-management goal, you can start with the ordinary grading nodes and explore these tools later.

ComfyUI-Darkroom Models

Darkroom's selectable film looks, camera profiles, and lens profiles are different kinds of presets or data—not AI models you need to prompt.

  • Color film stocks: 111 choices in Film Stock (Color). Use them for an overall photographic palette and tone, then refine the look with the node's curve and tone controls.
  • Black-and-white stocks: 50 choices in Film Stock (B&W), including pushed variants. Try these when you want a film-specific monochrome starting point.
  • Spectral Film Stock: 35 pre-baked negative-and-print LUT presets. These simulate a longer photographic chain: light is recorded by a film stock and, where applicable, rendered through a print stock. Choices span still photography, cinema, reversal slides, instant film, niche stocks, and black and white. For example, a Vision3-and-print-stock combination gives you a different starting point from a Velvia reversal look or a Tri-X black-and-white look.
  • Lens Profile: 102 lens models across brands and vintage lenses. Choose a profile when you want its combined distortion, color-fringing, and vignette behavior.
  • Camera Looks: Adobe .dcp profiles, when present and compatible with your RAW camera body. These are for developing camera RAW files, not general-purpose AI-image presets.

For quick experimentation, begin with Film Stock (Color) or Film Stock (B&W). Try Spectral Film Stock when you specifically want to explore the combined character of a film and its print or display process.

What's New with ComfyUI-Darkroom

The provided documentation identifies two version-specific changes:

  • Version 1.27.0 — restricted file access. File paths supplied through workflows or Darkroom's Browse dialog are limited to approved folders. This helps protect files on the machine running ComfyUI, especially if its interface can be reached by others. By default, Darkroom reads from ComfyUI's input/, output/, temp/, and models/ folders, and writes to output/.
  • Version 1.28.0 — faster color and film processing. Twenty-four color-grading and film-stock nodes gained GPU processing. The author reports typical speedups of 15–80× on a 24-megapixel image, depending on the node and hardware. Without a GPU, the same processing can run on the CPU.

The documentation also describes the LUT Bake Inject / Extract workflow as an improvement over grading a photo and an identity lattice in two duplicated chains. It lets you use one set of grading settings for both. No version number is supplied for that change.

Troubleshooting ComfyUI-Darkroom

A RAW file or .cube LUT cannot be opened

  1. Check that the file is in a folder Darkroom is allowed to read. By default, those are ComfyUI's input/, output/, temp/, and models/ folders.

  2. If you enter a relative path, remember that read paths start from input/.

  3. If the file must remain elsewhere, someone with access to the machine can add its folder to darkroom_allowed_folders.json beside ComfyUI's main.py. For example:

    [
      "D:/Photos/RAW",
      "E:/Grading/LUTs"
    ]
    
  4. Try browsing to the file again. Changes to the allowed-folder list take effect without a restart.

Folders added to this list are allowed for both reading and writing, so include only locations you trust.

A LUT or CMYK TIFF will not export to the chosen location

  1. Try the default destination first: ComfyUI/output/luts/ for LUTs or ComfyUI/output/cmyk/ for CMYK TIFFs.
  2. For a custom destination, confirm that its folder is allowed in darkroom_allowed_folders.json. By default, Darkroom writes only inside ComfyUI's output/.
  3. If you use a relative write path, it starts from output/.

A selected RAW Camera Look does not appear in the image

  1. Check that you are processing a RAW file from the camera body associated with the profile.
  2. Confirm that the relevant .dcp profile is available in a location Darkroom searches.
  3. Check the ComfyUI console for a warning. When the selected look is unavailable for the detected body, RAW Load falls back to Adobe Standard.

A baked LUT looks wrong, or grain and blur are missing

  1. Inspect the nodes between LUT Bake Inject and LUT Bake Extract.
  2. Keep only color-only adjustments there. Do not put Film Grain, Halation, Light Leak, sharpening, lens distortion, Auto White Balance, or other spatial or image-dependent effects in that section.
  3. Connect the extracted graded photo to any spatial effects after Extract. The exported .cube will contain the color grade; your finished photo can contain both the grade and the spatial effects.

The Kantorovich Color Match method is unavailable

The Kantorovich option requires the optional POT package. If it is unavailable, choose Reinhard, Wasserstein, or Forgy instead; the documentation states these work without POT.

Frequently asked questions

Do I need a GPU?
No. Darkroom can run without one. A GPU can make supported color-grading and film-stock nodes considerably faster.

Does Darkroom use an online service or require an API key?
No. Its image processing runs locally, with no per-image API cost.

Can I apply a LUT to recreate an entire film-damage workflow?
No. A LUT can store color changes, but not the positions of scratches, grain, borders, light leaks, or other spatial details. Use Darkroom's effect nodes for those parts of the look.

Is Halftone a reliable print proof?
No. Halftone is a visual effect. Use the CMYK soft-proof and gamut-checking nodes when preparing work for print, and follow your printer's specifications.

Why does Water Refraction look subtle?
Check field_width_mm. The effect is designed around a physical viewing area; a wide view of an entire screen can show little visible refraction, while a much smaller framed area can show a stronger macro effect.

Learn More about ComfyUI-Darkroom

ComfyUI-Darkroom Related Nodes

RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

ComfyUI-Darkroom detailed guide | ComfyUI