# Comfyui CoTracker Node

This is a node that outputs tracking results of a grid or specified points using CoTracker.  
It can be directly connected to the WanVideo ATI Tracks Node.  




<br>
<div><video controls height="300" src="https://github.com/user-attachments/assets/8b3be543-6917-42cb-8714-38c556ec5240" muted="false"></video></div>
<br>

[Other examples can be found here.](example.md)

<br>


## Example Workflow
![workflow](images/workflow.png)  

[workflow with perlin](images/workflow_perlin.png)  
[workflow with xyamp](images/workflow_xyamp.png)  


## Changelog
### 2025-6-4
1st commit

### 2025-6-6
added utility node
- PerlinCoordinateRandomizerNode  
Applies Perlin noise-based randomization to coordinate data, adding natural, smooth variations to tracking points across frames. 
- XYMotionAmplifierNode  
Amplifies coordinate movement with directional control for X/Y axes, preserving static points while enhancing motion intensity with optional mask-based selection.
- GridPointGeneratorNode  
Generates a grid of coordinate points.

### 2025-6-8
Added the enable_backward option. This is an experimental feature intended for tracking objects that don't appear in the first frame.  
Fixed a bug where the min_distance option was sometimes ignored.  

### 2025-6-24
ver 1.0.3  
Fixed a bug that could trigger errors in OpenCV functions.  
Fixed an issue where certain mask shapes were not handled correctly.  

### Related resources
- [CoTracker](https://github.com/facebookresearch/co-tracker)
- [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper)