WanVideo Draw WanMove Tracks

This is a preview/debug node for Wan-Move, the trajectory-guided motion system. Wan-Move (from ali-vilab) lets you drive video generation by specifying trajectories - you say "this point moves along this path" and the model animates accordingly, latent-trajectory guidance rather than pose or depth. The catch with trajectory control is it's invisible: a TRACKS object is just numbers. This node draws those tracks onto your images so you can actually see the paths you're asking the model to follow before you commit to a render.

That's the whole job. It takes your images and your tracks, overlays the trajectories as lines and dots, and gives you back an image you can eyeball. GSC-wise it's one of the better-performing nodes in this batch, which tracks - people building Wan-Move workflows genuinely need to check their paths.

How it works

You feed in the images (your frames or reference) and the tracks (the trajectory data, from whatever produced them upstream). The node renders each track's path across the frame - a line showing the route, a circle marking the point - composited over the image at an opacity you set. Nothing about this touches the generation; it's purely a visualization so you can confirm the motion is going where you intended. Get the tracks looking right here, then feed the same tracks into the actual Wan-Move conditioning.

The inputs and outputs that matter

• images (IMAGE) - the frames to draw on top of.
• tracks (TRACKS) - the trajectory data to visualize. This is the thing you're checking.
• opacity (default 0.5) - how strongly the overlay is drawn over the image. Turn it up to see the paths clearly against a busy image, down to keep the underlying picture visible.
• line_width (default 14) and circle_size (default 10) - thickness of the path lines and the size of the point markers. Cosmetic; bump them up for a quick glance, down for dense track sets where fat lines overlap into mush.
• line_resolution (default 24) - how finely the path curve is drawn. Higher is smoother.

Output: image (IMAGE) - the annotated preview. Send it to a Preview Image node and look.

How to install it

ComfyUI Manager → search ComfyUI-WanVideoWrapper, install, restart. Manual:

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

then restart. This node itself needs nothing extra - it's pure drawing. The Wan-Move workflow around it, of course, needs the Wan-Move model and a way to author or extract the tracks in the first place.

Common issues & troubleshooting

The overlay is unreadable - too dense or too faint. That's what opacity, line_width and circle_size are for. Dense track sets need thin lines and small dots; a single trajectory over a busy scene needs higher opacity to stand out.

Tracks don't line up with the image. The tracks and the images have to be in the same coordinate space and frame count. If the paths float off the subject, you're likely visualizing tracks authored at a different resolution than the images you drew them on.

This didn't change my generation. Right - it's a preview, full stop. Drawing the tracks doesn't feed them to the model. Route the actual tracks into the Wan-Move conditioning node; use this one only to check your work.

Node missing. Wan-Move support is recent; update WanVideoWrapper and restart if the class isn't there.