> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-service-account.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MoviePy Video Tools

> Agno MoviePyVideoTools enable an Agent to process videos, extract audio, generate SRT caption files, and embed rich, word-highlighted captions.

## Prerequisites

To use `MoviePyVideoTools`, you need to install `moviepy` and its dependency `ffmpeg`. The example below also uses `OpenAITools`, which needs `openai`:

```shell theme={null}
uv pip install moviepy ffmpeg openai
```

**Important for Captioning Workflow:**
The `create_srt` and `embed_captions` tools require a transcription of the video's audio. `MoviePyVideoTools` itself does not perform speech-to-text. You'll typically use another tool, such as `OpenAITools` with its `transcribe_audio` function, to generate the transcription (often in SRT format) which is then used by these tools.

## Example

The following example demonstrates a complete workflow where an agent uses `MoviePyVideoTools` in conjunction with `OpenAITools` to:

1. Extract audio from a video file
2. Transcribe the audio using OpenAI's speech-to-text
3. Generate an SRT caption file from the transcription
4. Embed the captions into the video with word-level highlighting

```python theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.moviepy_video import MoviePyVideoTools
from agno.tools.openai import OpenAITools

video_tools = MoviePyVideoTools(
    enable_process_video=True, enable_generate_captions=True, enable_embed_captions=True
)

openai_tools = OpenAITools()

video_caption_agent = Agent(
    name="Video Caption Generator Agent",
    model=OpenAIResponses(
        id="gpt-5.2",
    ),
    tools=[video_tools, openai_tools],
    description="You are an AI agent that can generate and embed captions for videos.",
    instructions=[
        "When a user provides a video, process it to generate captions.",
        "Use the video processing tools in this sequence:",
        "1. Extract audio from the video using extract_audio",
        "2. Transcribe the audio using transcribe_audio",
        "3. Generate SRT captions using create_srt",
        "4. Embed captions into the video using embed_captions",
    ],
    markdown=True,
)

video_caption_agent.print_response(
    "Generate captions for {video with location} and embed them in the video"
)
```

## Toolkit Functions

These are the functions exposed by `MoviePyVideoTools`:

| Function         | Description                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| `extract_audio`  | Extracts the audio track from a video file and saves it to a specified output path.                    |
| `create_srt`     | Saves a given transcription (expected in SRT format) to a `.srt` file at the specified output path.    |
| `embed_captions` | Embeds captions from an SRT file into a video, creating a new video file with word-level highlighting. |

## Toolkit Params

These parameters are passed to the `MoviePyVideoTools` constructor:

| Parameter                  | Type   | Default | Description                        |
| -------------------------- | ------ | ------- | ---------------------------------- |
| `enable_process_video`     | `bool` | `True`  | Enables the `extract_audio` tool.  |
| `enable_generate_captions` | `bool` | `True`  | Enables the `create_srt` tool.     |
| `enable_embed_captions`    | `bool` | `True`  | Enables the `embed_captions` tool. |
| `all`                      | `bool` | `False` | Enables all functions.             |

## Developer Resources

* [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/moviepy_video.py)