Video

The Video component allows users to upload, record, or play video files.

Basic usage

import gradio as gr

def process_video(video):
    return video  # Return processed video path

gr.Interface(
    fn=process_video,
    inputs=gr.Video(),
    outputs=gr.Video()
).launch()

Constructor

str | Path | Callable | None

default:"None"

Default video as filepath or URL

str | None

default:"None"

File extension for video (e.g., “mp4”, “avi”). Use “mp4” for browser playability

list[Literal['upload', 'webcam']] | None

default:"None"

Input sources:

"upload" - File upload
"webcam" - Webcam recording

Defaults to both

int | str | None

default:"None"

Component height in pixels or CSS units

int | str | None

default:"None"

Component width in pixels or CSS units

bool

default:"False"

Whether to automatically play video when displayed

bool

default:"False"

Whether video loops when it reaches the end

bool | None

default:"None"

Whether to include audio track. Defaults to True for uploads, False for webcam

Events

change - Triggered when video changes
upload - Triggered when video is uploaded
clear - Triggered when video is cleared
play - Triggered when playback starts
pause - Triggered when playback pauses
stop - Triggered when playback stops
end - Triggered when playback ends
start_recording - Triggered when recording starts
stop_recording - Triggered when recording stops

Examples

Webcam only

import gradio as gr

gr.Video(
    sources=["webcam"],
    label="Record a video"
)

Ensure MP4 format

import gradio as gr

gr.Video(
    format="mp4",
    label="Upload video (will be converted to MP4)"
)

Overview

Input Components

Output Components

Layout Components

Control Components

Special Components

Basic usage

Constructor

Events

Examples

Webcam only

Ensure MP4 format

​Basic usage

​Constructor

​Events

​Examples

​Webcam only

​Ensure MP4 format

Basic usage

Constructor

Events

Examples

Webcam only

Ensure MP4 format