Skip to content

macx/kirby-tw-transcript

Repository files navigation

Tw Podcast Transcript

Beta Kirby plugin for convenient import, management, and audio sync of podcast transcripts.

Status

This plugin currently tracks the beta release line and is prepared for Composer-based installation. Install the latest stable release by default or explicitly require a beta version while the plugin is still pre-1.0.

Features

  • Multiline transcript format (Speaker → Timestamp → Text)
  • Panel importer (TXT upload, paste, ElevenLabs TXT, DOTE JSON, ElevenLabs JSON)
  • Preview with validation
  • Block integration for any episode
  • Audio sync with Podlove Web Player v5

Transcript Format

Simple multiline format with blank line separators:

Speaker Name
MM:SS or HH:MM:SS
Transcript text content

Next Speaker
MM:SS or HH:MM:SS
More text content

Rules:

  • Line 1: Speaker name
  • Line 2: Timestamp (MM:SS or HH:MM:SS) – optional
  • Line 3+: Text (can span multiple lines)
  • Blank line: Segment separator

The importer also accepts additional transcript exports:

  • ElevenLabs TXT with timestamp ranges like 00:00:00,520 --> 00:00:07,470 [Speaker]

  • DOTE JSON with lines/startTime/speakerDesignation/text

  • ElevenLabs JSON with segments/start_time/speaker/text

For ElevenLabs imports, the segment text is used as the paragraph content. The nested words array is ignored.

Installation

  • Unzip to site/plugins/kirby-tw-transcript
  • Or install the latest stable release via Composer:
composer require macx/kirby-tw-transcript
  • Or install the latest beta via Composer:
composer config repositories.kirby-tw-transcript vcs https://github.com/macx/kirby-tw-transcript
composer require macx/kirby-tw-transcript:"@beta"
  • Or install a specific beta version:
composer require macx/kirby-tw-transcript:"0.10.0-beta.1"

Quickstart

  1. In Kirby Panel: Go to "Transcript Import" area
  2. Upload a TXT or JSON file, or paste transcript text/JSON
  3. Review preview, select target episode, import
  4. Transcript saved as block and synced with player

Release Flow

See PUBLISHING.md for the exact beta, tagging, GitHub, and Composer release flow.

License

MIT

About

Import and synchronize audio transcripts as native Kirby 5 Blocks. Built for the relaunch of Germany's pioneer developer podcast Technikwürze.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors