> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringbee.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Metadata & Inspection

> Read, strip, and inspect file metadata

## metadata

Read all metadata (EXIF, IPTC, XMP) from a file.

```json theme={null}
{ "type": "pipeline_metadata" }
```

Returns a JSON object with all metadata fields.

## strip\_metadata

Remove all metadata from a file (privacy, file size reduction).

```json theme={null}
{ "type": "pipeline_strip-metadata" }
```

## file\_inspect

Inspect file type, size, and basic properties without processing.

```json theme={null}
{ "type": "pipeline_file-inspect" }
```

Returns file type (MIME), size, and format-specific details.

***

## Combined Pipeline Operations

These advanced operations combine multiple tools (FFmpeg + libvips) in a single job.

### sprite\_sheet

Generate a sprite sheet from video frames (useful for video scrubbing).

```json theme={null}
{ "type": "pipeline_sprite-sheet", "params": { "columns": 10, "width": 160, "interval": 5 } }
```

### contact\_sheet

Generate a contact sheet (grid of thumbnails) from a video.

```json theme={null}
{ "type": "pipeline_contact-sheet", "params": { "columns": 4, "rows": 4, "width": 1920 } }
```

### social\_media\_pack

Generate optimized versions for multiple social media platforms.

```json theme={null}
{ "type": "pipeline_social-media-pack", "params": { "platforms": ["instagram", "twitter", "facebook"] } }
```

### responsive\_image\_set

Generate multiple sizes for responsive web design.

```json theme={null}
{ "type": "pipeline_responsive-image-set", "params": { "widths": [320, 640, 1024, 1920] } }
```

### smart\_thumbnail

Automatically select the best frame from a video for a thumbnail.

```json theme={null}
{ "type": "pipeline_smart-thumbnail", "params": { "width": 1280 } }
```

### video\_watermark

Add an image watermark to a video (persistent across all frames).

```json theme={null}
{ "type": "pipeline_video-watermark", "params": { "watermark_url": "https://example.com/logo.png", "position": "bottom-right" } }
```

### animated\_preview

Generate an animated GIF/WebP preview from key moments in a video.

```json theme={null}
{ "type": "pipeline_animated-preview", "params": { "duration": 5, "format": "webp" } }
```

### podcast\_visual

Generate a visual waveform video from an audio file (for social media sharing).

```json theme={null}
{ "type": "pipeline_podcast-visual", "params": { "background_color": "#1a1a2e", "wave_color": "#e94560" } }
```

### document\_preview

Generate preview images from document pages.

```json theme={null}
{ "type": "pipeline_document-preview", "params": { "pages": 3, "width": 800 } }
```

### qc\_report

Generate a quality control report for a video file (bitrate graph, codec info, frame analysis).

```json theme={null}
{ "type": "pipeline_qc-report" }
```