Nodes/ComfyUI-TopazVideoLocal/Topaz Upscale Params
ComfyUI Node

Topaz Upscale Params

The tuning side of every Topaz upscale — profiles first, sliders second

By donangel85·Created 2 days ago·Updated 2 days ago· 0
Topaz Upscale Params
    • params
    profilemanual
    profile_strength1.00
    preblur0.00
    noise0.00
    details0.00
    halo0.00
    blur0.00
    compression0.00
    prenoise0.000
    grain0.00
    grain_size0.0
    grain_typedefault
    blend0.00
    color_correctiontrue
    auto_estimate_frames0
    edit_preset_valuesfalse

    Every upscale model in the ComfyUI-TopazVideoLocal pack has a bag of tuning parameters - noise removal, detail recovery, halo reduction, compression cleanup - and this node is where you set them. It produces a params bundle you feed into the params socket of any upscale-capable node (video, image, even the deinterlace and motion-deblur wrappers), so you can build one tuning profile and reuse it across a graph instead of re-setting sliders per node.

    The honest advice for a beginner: don't touch the sliders at all on your first runs. Topaz's models at 2x with default tuning already beat a plain Lanczos resize by a wide margin (the pack measured 28.56 dB / SSIM 0.928 against Lanczos's 27.75 / 0.919 on real footage). The node exists for when default isn't good enough - noisy source, compressed source, AI-generated video, archive film - and that's what the profile dropdown is for.

    The two ways to use it

    profile (default manual) is the top-level switch. Leave it on manual and the sliders below apply as usual. Pick anything else and that profile's values get used. Three kinds of entry appear and the prefix tells them apart:

    • Topaz: … - read live from Topaz Video's own preset folder, authored by Topaz Labs (only the ones that actually set tuning values; the rest just pick a model and output settings).
    • My: … - presets you've saved yourself.
    • No prefix - starting points shipped with this pack, like Compressed / web video, Old film / archive, AI-generated video. Useful defaults, not official Topaz values.

    Then profile_strength scales whatever profile you picked - 0.5 is half as aggressive, 0 disables its tuning entirely. Change it before picking the profile, or use the reload button after.

    The sliders that matter

    All run -1 to 1 and the tooltips are the author's own descriptions, so trust them: noise removes ISO noise (too high also removes fine detail), details recovers texture lost to in-camera noise suppression, halo reduces ringing around strong edges from oversharpening, blur adds sharpening for soft sources, compression reduces blockiness from codecs, preblur goes negative for aliasing/moire or positive for lens blur. Beyond those, grain (with grain_size and grain_type) adds film grain, blend mixes the original back in, and prenoise adds noise before processing - all optional, all zero by default, and all easy to overdo.

    Two more worth naming: color_correction (on by default) does extra colour correction where the model needs it, and auto_estimate_frames analyses up to N frames to estimate the parameters automatically - 0 disables it. That's the same estimation family as the separate Topaz Parameter Estimate node, inline.

    The presets-in-the-browser bit

    The node ships a small frontend extension. In the browser, picking a profile copies its values into the sliders so you can see what it actually does and adjust - and edit_preset_values (the last widget on the node) decides who wins: off means the preset runs exactly as authored and the sliders are ignored; on means your edited sliders count. It defaults to off, but picking a profile in the browser turns it on for you, because the sliders now hold that preset's values and adjusting them is the point. Two buttons round it out: Reload preset into sliders (discard an experiment and start over) and Save sliders as preset (stores the current values as My: <name>, kept in user_presets.json beside the package). Through the plain API, without the browser extension, the dropdown behaves like a normal server-side control and edit_preset_values stays off.

    Install

    It ships in the pack:

    git clone https://github.com/donangel85/ComfyUI-TopazVideoLocal.git
    

    from ComfyUI's custom_nodes folder, restart. No pip step beyond numpy; ComfyUI Manager finds it under "TopazVideoLocal". Real requirements underneath: Windows, a licensed signed-in Topaz Video installation.

    Common issues

    The classic confusion is adjusting sliders and seeing no change - that's edit_preset_values sitting in the "preset as-is" position, so the profile wins and your edits are ignored. The second is mistaking a shipped starting-point profile for an official Topaz value; the log line after each run shows exactly what got resolved, so check it if a result looks more aggressive than you intended.

    CategoryTopaz Video Local

    Inputs (16)

    NameTypeDefaultDescription
    profileCOMBOmanualmanual: use the sliders below. Picking anything else copies that preset's values into the sliders, where you can adjust them. Entries prefixed 'Topaz:' come from Topaz Video's own presets, 'My:' are your own saved ones, and the rest ship with this package.
    profile_strengthFLOAT1.000–2Scales a profile's intensity. 0.5 is half as aggressive, 0 disables its tuning. No effect in manual mode. Change this before picking the profile, or press 'Reload preset into sliders' afterwards.
    preblurFLOAT0.00-1–1Negative for aliasing/moire in the source, positive for lens blur.
    noiseFLOAT0.00-1–1Remove ISO noise. Too high also removes fine detail.
    detailsFLOAT0.00-1–1Recover texture lost to in-camera noise suppression.
    haloFLOAT0.00-1–1Reduce ringing around strong edges from oversharpening.
    blurFLOAT0.00-1–1Additional sharpening for soft sources.
    compressionFLOAT0.00-1–1Reduce blockiness and mosquito noise from codecs.
    prenoiseoptFLOAT0.0000–0.1Noise added before processing.
    grainoptFLOAT0.000–1Film grain added to the output.
    grain_sizeoptFLOAT0.00–5Size of the added grain.
    grain_typeoptCOMBOdefault4 options: default, silver_rich, gaussian, grey
    blendoptFLOAT0.000–1Blend the original back into the result.
    color_correctionoptBOOLEANtrueExtra colour correction where the model needs it.
    auto_estimate_framesoptINT00–100Analyse this many frames to estimate the parameters above automatically. 0 disables estimation and uses the values as given.
    edit_preset_valuesoptBOOLEANfalseWhich values actually run. Off: the profile at the top is applied as authored and the sliders are ignored. On: the sliders are used, so your adjustments count. Picking a profile in the browser fills the sliders and turns this on for you. Turn it off to go back to the untouched preset — your slider values are kept.

    Outputs (1)

    NameTypeDescription
    paramsTOPAZ_UPSCALE_PARAMS