Add transcripts to Libsyn episodes in bulk

1. Open the Episodes list in Libsyn, find the episode, click the menu icon and choose Edit.
2. Go to the Assets tab and drop the .srt or .vtt file into the Add Episode Transcript area; an icon shows that a transcript is attached.
3. Publish or save the episode, then open the Quick Links window from the Episode Details if you need the transcript URL.
4. Repeat for every episode, matching "ep142_final_v3.vtt" to the right title by hand. A file attached to the wrong episode looks fine in Libsyn and is only noticed by a listener.

Attach the VTT transcripts in /transcripts to the matching episodes of The Solo Founder Show and tell me which files had no match.

1. 01

   Match files to episodes first

   The agent reads list_episodes and pairs each file with an episode by number, date or title words in the file name. A file that fits two episodes, or none, is set aside and listed; nothing is attached on a guess.

2. 02

   Reject what Libsyn will not take

   Only .srt and .vtt files go forward. A .txt or .docx transcript is reported back with a note that it needs converting, since Libsyn accepts no other format.

3. 03

   Sanity-check the content

   Before uploading, the agent opens get_episode and compares the title and guest with the first lines of the transcript. A file whose last timestamp is far shorter than the rest of the batch, or whose opening names another guest, is flagged as a likely wrong file.

4. 04

   Attach with your OK

   upload_transcript runs once per matched pair and asks for your OK by default, because the transcript becomes part of the public feed. You can approve the whole matched list in one go.

5. 05

   Remind you about Apple

   At the end the agent says whether you still need to switch Apple Podcasts to your own transcripts, and how, based on whether you submitted the show to Apple yourself.

23 files in /transcripts, 22 episodes matched.
21 attached: ep120 to ep141 except ep133.
ep133.vtt held back: it ends at 18:40 while the others run 45 to 60 minutes, and it opens with another guest. Probably the wrong file.
interview-dana.srt: no episode with Dana in the title. Which episode is it?
notes-ep139.docx skipped: convert it to .vtt or .srt first.
Apple Podcasts still shows its own transcripts until you change the setting in Podcasts Connect.

• Libsyn accepts transcripts only as SRT or VTT files, uploaded on the Assets tab of the episode form.
• Libsyn automatically generates a podcast:transcript tag with the file URL and type (text/srt or text/vtt) for the episode in the RSS feed.
• Apple Podcasts creates its own transcripts by default; to show yours, change the transcript setting in Apple Podcasts Connect, or email support@libsyn.com if Libsyn submitted the show to Apple.
• Libsyn shows the hosted transcript URL in the Quick Links window of the Episode Details, and the Remove button on the Assets tab takes the file off the episode.

upload_transcript asks for your OK by default. To run it on a schedule without you, switch confirmation off for that tool in your dashboard.

Sources: Libsyn help: Add Your Own Episode Transcript · Libsyn help: Publish an Episode

curl https://cotlet.dev/api/v1/libsyn/upload_transcript \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"episode_id":"38415502","file_url":"https://files.example.com/transcripts/ep-142.vtt"}'

{
  "episode_id": "38415502",
  "transcript": {
    "format": "vtt",
    "status": "attached"
  }
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is libsyn_upload_transcript. Example data.

• Schedule Libsyn podcast episodes with an AI agent
• Update Libsyn show notes across many episodes
• Get a monthly Libsyn downloads report for sponsors
• Libsyn API and MCP server: every tool
• All use cases