Loop Count

Sets the number of times the video loops in the output file.

video-loop accepts an integer. The value specifies how many times the video content is repeated in the encoded output. A value of 2 produces a video that plays the clip twice end-to-end.

For animated formats (GIF, WebP), a value of -1 enables infinite looping. For standard video (MP4), negative values are ignored.

Note that this encodes the repetitions into the output media file itself, increasing the file duration and size proportionally. This differs from client-side looping set via the HTML loop attribute, which replays the same file without increasing its size.