Flex Mask Wave Propagation ⚡🅡🅞🅣🅘

Close cousin to Flex Mask Emanating Rings, but built on wave-simulation math instead of simple concentric circles - this one models an actual decaying oscillation spreading outward from your mask, the classic "stone dropped in a pond" visual, with real wave physics vocabulary (speed, amplitude, decay, frequency) rather than a fixed ring pattern. It's the pick when you want something that reads as a physical ripple rather than a graphic ring effect.

How it works

wave_speed sets how fast the wavefront travels outward from the source. wave_amplitude is the wave's height - how strongly it displaces the mask value at its peak. wave_frequency controls how tightly packed the oscillations are (more frequency, more ripples per unit distance, closer to a texture; less, and you get a single broad pulse). wave_decay governs how quickly the wave loses energy as it travels - high decay means the ripple dies out fast near the source, low decay lets it propagate much further before fading. max_wave_field caps the overall size of the simulated field the wave is allowed to occupy. Five of these - speed, amplitude, decay, frequency, and the field size itself - are available through feature_param, so an audio feature can drive the propagation speed or the wave's height directly, which is the more physically grounded sibling to Emanating Rings' simpler propagation model.

Inputs and outputs that matter

• masks (required, MASK) - the source the wave originates from.
• wave_speed (default 50, 0.1–100) - propagation speed.
• wave_amplitude (default 1, 0.1–2) - wave height/displacement.
• wave_decay (default 5, 0.9–10) - how fast the wave loses energy.
• wave_frequency (default 0.1, 0.01–10) - oscillation density.
• opt_feature (optional, FEATURE) - drive speed, amplitude, decay, frequency, or field size reactively.
• Output - a single MASK.

Installing it

Via ComfyUI Manager: search "RyanOnTheInside," install, restart. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/ryanontheinside/ComfyUI_RyanOnTheInside.git
cd ComfyUI_RyanOnTheInside
pip install -r requirements.txt

then restart. Simulation math on the mask, no model downloads.

Common issues & troubleshooting

Wave dies out almost immediately. wave_decay's default sits mid-range (5, out of a 0.9–10 scale) - if your ripple isn't traveling far enough before fading, lower it; higher values are for a sharp, contained pulse rather than a far-reaching ripple.

Looks like a texture, not a wave. wave_frequency set too high packs many oscillations close together, which reads as fine ripple texture rather than a single visible wavefront. Drop it toward the low end of its range for a cleaner, more singular ripple.

Nothing visible across a short clip. Like Emanating Rings, this is fundamentally a sequence effect - wave_speed needs frames to actually propagate anything. On a very short clip, push wave_speed up or give the sequence more length before assuming it's inert.