Podcasts

File: 07-podcasts.md

Loading documentation...

# Podcasts

## Overview

Manage podcast series with episodes, contributors, categories, tags, and RSS. Supports native hosting or syncing from external RSS.

## Features
- Create/edit podcasts, manage artwork and metadata
- Import from external RSS (fetch info, episodes)
- Manage contributors with roles
- Categorization and tagging
- Generate RSS feed (native)

## Data Model
- `Podcast` → user_id, title, description, slug, image_media_id, rss fields, meta, status
- `Episode` → podcast_id, season_id, media (audio/image), metadata, status, published_at
- `Season` → podcast_id, name, season_number
- Pivots: `podcast_contributors`, `podcast_categories`, `podcast_tags`, `episode_contributors`, `episode_categories`, `episode_tags`

## Key API Endpoints
- Podcasts: `/api/podcasts` (index/show/store/update/delete)
- Contributors: `/api/podcasts/{podcast}/contributors` (list/add/update-role/remove)
- Tags/Categories: `/api/podcasts/{id}/tags`, `/api/podcasts/{id}/categories`
- RSS: `/api/podcasts/{id}/generate-rss`, `/api/podcasts/{id}/rss-info`, `/api/validate-rss-url`, `/api/podcasts/{id}/load-rss-*`
- Episodes: `/api/episodes` (CRUD), plus `/api/episodes/{id}/audio|image` for uploads

## Usage Examples
```javascript
// Create a podcast
const podcast = await apiPost('/api/podcasts', {
  title: 'My Show',
  description: 'About the show',
  slug: 'my-show'
});

// Upload cover image (FormData)
const formData = new FormData();
formData.append('image', file);
await apiPut(`/api/episodes/${episodeId}/image`, formData);

// Generate RSS
await apiPost(`/api/podcasts/${podcastId}/generate-rss`);
```

## RSS Workflows
- External: validate RSS URL → load RSS info → load RSS episodes
- Native: create podcast → create episodes → generate RSS

## Tips
- Slug uniqueness accounts for soft deletes
- Use media library for audio and images
- Use categories and tags for discoverability

Podcasts

Podcasts

📝 Page Notes

Add New Note