Media

File: 09-media.md

Loading documentation...

# Media Library

## Overview

Upload, manage, and reuse media (images, audio, video, documents). Create lists/playlists and short clips.

## Features
- Upload with progress and metadata
- Derivative media and thumbnails
- Playlists/collections with ordering
- Short clips for social

## Data Model
- `Media` → user_id, type, path, thumbnail_path, title, description, alt_text, file_size, duration, mime_type, source_media_id, status
- `MediaClip` → media_id, title, start_time, end_time, duration
- `MediaList`/`MediaListItem` → ordered playlist items

## Key API Endpoints
- Media: `/api/media` (list/store/show/update/delete)
- Media Lists: `/api/media/lists` (list/show/store/update/delete, add/remove/reorder items)
- Media Clips: `/api/media-clips` (list/show/store/update/delete, duplicate)

## Upload Patterns
```javascript
// With progress
const media = await uploadFileAndCreateMedia(file, {
  title: 'Cover', alt_text: 'Cover art'
}, (p) => console.log(p));

// Basic upload
const fd = new FormData();
fd.append('file', file);
await apiFileUpload('/api/media', fd);
```

## Tips
- Use `alt_text` for accessibility
- Prefer playlists for ordering content in sections
- Clip durations are decimals (seconds)

Media

Media

📝 Page Notes

Add New Note