-
Notifications
You must be signed in to change notification settings - Fork 1
Podcasts
Guides for creating and managing podcast shows in HarborFM.
A show (podcast) is the top-level container in HarborFM. Each show has its own episodes, library usage, and optional collaborators.
- From the dashboard, click the option to create a new podcast (e.g. "New podcast" or "Create show").
- Enter a name for the show (and any other required fields).
- Save or continue. You'll land on the show's main page.
You can then add episodes and configure show settings. The dashboard lists all shows you own or collaborate on.
- Show settings and artwork - Set artwork, description, categories, and social links.
- Collaborators and permissions - Invite others and set their roles.
- Episodes - Create and manage episodes for this show.
From the show page (or Settings for the show) you can configure how your podcast appears and where it's delivered.
- Artwork - Upload a cover image for the show. This is used in the RSS feed and on public pages.
- Description - Show description for the feed and any public show page.
- Categories - Podcast categories (e.g. for Apple Podcasts) if supported.
- Explicit - Mark the show as explicit if applicable.
- Social links - Add links (e.g. website, Twitter, Patreon) shown on the show or feed.
Exact fields depend on your HarborFM version; use the show's Settings or Edit UI to see all options.
On the show page you can configure Podcast Delivery: where the RSS feed and episode audio are deployed (e.g. S3, R2, FTP, SFTP, WebDAV, IPFS, SMB). Credentials are stored encrypted. See Export and delivery.
- Subscriber Only Messages - When Subscribers Enabled is on, the toggle Subscriber Only Messages (off by default) restricts the Message button on public podcast and episode pages to visitors signed in as subscribers. The contact API returns 403 for that podcast when the request is not from an authenticated subscriber.
- Show Scheduled Episodes - The toggle Show Scheduled Episodes (off by default) appears below Allow Unapproved Reviews in Edit Podcast Details. When on, episodes that are scheduled or published with a future publish date appear on the public feed and episode pages with a Premiering [date] placeholder instead of the player; markers, waveforms, and audio are not loaded or served until the release date.
- Reviews - You can enable optional CAPTCHA and subscriber-only reviews per podcast. Managers and owners can approve or hide reviews in the show or admin UI. For how listeners submit and see reviews, see Public feeds and embed: Reviews.
You can invite other users to work on a show with a specific role. Access is role-based; admins have full access to all shows.
| Role | Allowed actions |
|---|---|
| View | List/read podcast and episodes, stream audio, view analytics. Read-only. |
| Editor | Everything in view, plus: edit segments, record new sections, render/build the final episode. |
| Manager | Everything in editor, plus: create/update episodes and episode artwork, edit show details, configure Podcast Delivery, manage collaborators (invite, change role, remove). |
| Owner | Full control. Only the owner can delete the podcast or transfer ownership. |
- New episode is available only to managers and the owner; view and editor roles see it disabled.
- Storage for the show (recorded segments, episode source audio) counts against the podcast owner's storage limit. If the owner is at or near their limit, "Record new section" may be disabled for everyone on that show.
- Open the show and go to Settings (or the show's settings area).
- Find Collaborators and click to invite (or add collaborator).
- Enter the collaborator's email and choose a role (view, editor, manager).
- Send the invite. If the person doesn't have an account yet, the UI can send an "invite to the platform" email (rate-limited by the instance).
They'll see the show on their dashboard according to their role.
From the same Collaborators section you can change a user's role or remove them. Only managers and the owner can manage collaborators; only the owner can delete the show or transfer ownership.
- Creating a show
- Show settings and artwork
- Main README - "Permissions" section for full role table