Video Generator#

This is a visualization tool only

The Video Generator is intended only for visualizing tracking results. To correct tracking errors or edit results, please use the Validator.

idtracker.ai provides a graphical tool to generate tracked videos from your tracking sessions. These videos visualize animal trajectories and can be used for further analysis or sharing results.

To launch the video generator, run:

idtrackerai_video

This opens a graphical interface where you can load your session and customize the video output.

idtracker.ai's video generator application (in dark mode)

idtracker.ai’s video generator application (in dark mode)#

idtracker.ai's video generator application (in light mode)

idtracker.ai’s video generator application (in light mode)#

You can generate two types of videos:

Pose estimation

Individual videos are ideal for extracting animal pose information with tools like SLEAP and DeepLabCut.

  • General Video: Shows the original video with all animal trajectories and optional labels overlaid (see the Youtube video on the left).

  • Individual Videos: Generates a separate video for each animal, showing only its own cropped region over time (see the Youtube video in the center), plus a collage video displaying all individuals in a grid (see the Youtube video on the right).

Resize video output

Use the resize option in the general video (full view with labels) to adjust the output video size. This can help reduce the output video file size, speed up the video generation and make it easier to share or store.

Alternative CLI

If you prefer to use the command line interface, run idtrackerai_video --run -h to display a list of all available options:

--run

Generate the video without GUI

--individual

Generate individual video. Default is a general video.

--gray

Draw the original video in grayscale.

--t

path Path to the trajectory file, default is session_dir/trajectories/trajectories*.

--tl

int Trail length, number of points used to draw the individual trajectories traces in general videos. Default is 20.

--s

int Frame where to start the video.

--e

int Frame where to end the video.

--size

int Size of the squared individual videos. Defaults to the median body length of the animals in pixels.

--no-labels

Show centroids in general video without labeled IDs.

Or check the Code reference idtrackerai.extra_tools.video_generator for calling the video generator from Python.