> For the complete documentation index, see [llms.txt](https://docs.degirum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.degirum.com/face-recognition/guides/overview-2.md).

# Face Clip Manager

Helper class for managing video clips saved by FaceTracker.

## What is FaceClipManager?

`FaceClipManager` manages video clips saved by `FaceTracker`'s alert recording pipeline. It provides simple methods to list, download, and remove clips from object storage.

Typically used with the same `clip_storage_config` from your FaceTracker setup.

## When to Use

Use `FaceClipManager` to manage clips saved by FaceTracker:

* List alert clips saved during monitoring
* Download clips for backup
* Implement retention policies (remove old clips)
* Clean up storage after review

**Typical workflow:**

1. Configure `FaceTracker` with `clip_storage_config` and alert mode
2. Run `FaceTracker.start_face_tracking_pipeline()` - saves clips when alerts trigger
3. Use `FaceClipManager` to list/download/remove saved clips

**For analyzing clips**, use [FaceTracker.find\_faces\_in\_clip()](/face-recognition/guides/overview-1/methods.md#find_faces_in_clip).

***

## How It Works

Initialize `FaceClipManager` with an `ObjectStorageConfig` - typically the same config used by FaceTracker:

```python
import degirum_face
import degirum_tools

# Use same storage config as FaceTracker
clip_manager = degirum_face.FaceClipManager(
    degirum_tools.ObjectStorageConfig(
        endpoint="./security_clips",
        bucket="unknowns"
    )
)

# List all clips
clips = clip_manager.list_clips()

# Download a clip
clip_data = clip_manager.download_file("incident_01.mp4")

# Remove old clips
clip_manager.remove_file("old_clip.mp4")
```

See [Configuration Guide](/face-recognition/guides/overview-2/configuration.md) for storage setup and FaceTracker integration.

See [Methods Reference](/face-recognition/guides/overview-2/methods.md) for complete API with examples.