podcast-transcript-convert

Convert podcast transcripts from HTML, SRT, WebVtt, Podlove etc into PodcastIndex JSON.

Installation

It is recommended to use pipx to install and run the CLI tool. If you wish to use the library, you can install with pip instead.

brew install pipx
pipx install podcast-transcript-convert

If you've already installed the package and wish to upgrade:

pipx upgrade podcast-transcript-convert

Usage

Run the conversion app on your transcripts directory.

transcript2json transcripts/ converted/

You can then inspect the output JSON files in the converted/ directory.

Library Usage

from podcast_transcript_convert.convert import bulk_convert

bulk_convert("transctipts_dir/", "converted_dir/")

Individual file type converters are in the converters package. You can use them directly if you know the file type.

You can use file_typing.identify_file_type(file) to determine the file type of a transcript file.

Development

Pull requests are very welcome! For major changes, please open an issue first to discuss what you would like to change.

git clone git@github.com:hbmartin/podcast-transcript-convert.git
cd podcast-transcript-convert
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# Replace with the actual path to your transcript files
python -m podcast_transcript_convert ~/Downloads/overcast-to-sqlite/archive/transcripts converted/

Code Formatting

This project is linted with ruff and uses Black code formatting.

Authors

• Harold Martin - harold.martin at gmail
• Icon courtesy of Vecteezy.com