Help

Command-Line Interface

Create podcast episodes from your terminal with the podread CLI.

Homebrew (macOS / Linux):

brew install jesse-spevack/tap/podread

Or with curl:

curl -fsSL https://raw.githubusercontent.com/jesse-spevack/podread-cli/main/install.sh | sh

Connect the CLI to your PodRead account:

podread auth login

A browser window opens where you confirm a device code. Once confirmed, the CLI is authenticated.

From a URL:

podread episode create --url https://example.com/article

From text:

podread episode create --text "Your text here" --title "My Episode"

From a file:

cat article.txt | podread episode create --stdin --title "Article"

The CLI waits for processing to finish by default (usually 1-5 minutes). Add --no-wait to return immediately.

podread voices
podread episode create --url https://example.com/article --voice alloy

podread episode list              # recent episodes
podread episode status <id>       # check processing status
podread episode delete <id>

podread feed

Add the URL to any podcast app. New episodes appear automatically.

Full documentation and source code are available on GitHub.