main
Co-authored-by: Cursor <cursoragent@cursor.com>
ComfyUI Camera Shake Node
A ComfyUI custom node that applies subtle, handheld-style camera shake to an image batch. It adds per-frame affine transforms (translate, rotate, scale) to simulate natural micro-movement, ideal for adding life to video/animation frame sequences.
Node
Batch Camera Shake (Subtle) — category: image/transform
Applies smoothed, seedable per-frame motion to an IMAGE batch ([B, H, W, C]).
Inputs
| Input | Type | Default | Description |
|---|---|---|---|
images |
IMAGE | — | Input image batch to apply the shake effect to |
seed |
INT | 0 | Random seed for reproducible shake patterns |
translate_px |
FLOAT | 2.0 | Max horizontal/vertical movement in pixels |
rotate_deg |
FLOAT | 0.15 | Max rotation angle in degrees |
scale_pct |
FLOAT | 0.5 | Max zoom variation as a percentage |
freq |
FLOAT | 1.0 | Shake frequency multiplier (higher = faster changes) |
smoothing |
FLOAT | 0.85 | Motion smoothness (higher = floatier, lower = jittery) |
distribution |
choice | even | Intensity curve over time: even, center, ramp_up, ramp_down, ease_in, ease_out, ease_in_out |
min_intensity |
FLOAT | 0.5 | Minimum intensity as a fraction of max (ignored when distribution is even) |
border |
choice | reflect | Edge handling: reflect, replicate, or zeros |
Output
| Output | Type | Description |
|---|---|---|
IMAGE |
IMAGE | The shaken image batch |
Installation
Clone this repository into your ComfyUI custom_nodes directory:
cd ComfyUI/custom_nodes
git clone https://github.com/tylervw99/ComfyUI-camera-shake-node.git
Restart ComfyUI. The node appears under image/transform as Batch Camera Shake (Subtle).
Requirements
Uses dependencies already shipped with ComfyUI:
torchnumpy
Languages
Python
100%