Skip to content
Veronese Docs

Command Reference

All commands accept --json for script-friendly output.

config

Section titled “config”

Manage CLI configuration.

Terminal window
veronese config set-url <url>      # Set the Veronese API URL
veronese config set-token <token>  # Set your API authentication token
veronese config show               # Display current configuration

Examples:

Terminal window
veronese config set-url https://veronesebook.com
veronese config set-token eyJhbGci...
veronese config show

status

Section titled “status”

Check your account status and remaining transcription credits.

Terminal window
veronese status

Example output:

Account:   you@example.com
Server:    https://veronesebook.com
Credits:   3,240s free  ·  7,200s paid

series

Section titled “series”

Manage series (collections of episodes).

Terminal window
veronese series list                       # List all series
veronese series create --title <title>     # Create a new series

Example output (list):

ID    Title             Episodes  Created
────────────────────────────────────────────
1     My Podcast        42        2025-01-01
2     Quick Notes        8        2025-06-15

episode

Section titled “episode”

Create, monitor, and export episodes.

create

Section titled “create”
Terminal window
veronese episode create --series <id> --url <url>
veronese episode create --series <id> --url <url> --title "Custom Title"

poll

Section titled “poll”

Wait for an episode to finish processing.

Terminal window
veronese episode poll <id>                    # Poll (default 5-min timeout)
veronese episode poll <id> --max-wait 600     # Custom timeout in seconds

show

Section titled “show”

Display full episode details.

Terminal window
veronese episode show <id>
veronese episode show <id> --json

events

Section titled “events”

View the processing event log for an episode — useful for diagnosing failures.

Terminal window
veronese episode events <id>

Example output:

2026-03-15 12:00:01  state_change  draft → ingesting
2026-03-15 12:00:08  state_change  ingesting → transcribing
2026-03-15 12:01:43  state_change  transcribing → ready

export

Section titled “export”

Download the completed transcript.

Terminal window
veronese episode export <id>                           # Print to stdout (plain text)
veronese episode export <id> --format md               # Markdown, stdout
veronese episode export <id> --format md --out out.md  # Save to file
veronese episode export <id> --format txt --out out.txt

Formats: txt (default), md

retry

Section titled “retry”

Retry a failed episode.

Terminal window
veronese episode retry <id>

token

Section titled “token”

Manage API access tokens.

Terminal window
veronese token list              # List all tokens
veronese token create --name <name>  # Create a new token (shown once)
veronese token delete <id>       # Revoke a token immediately

Full workflow example

Section titled “Full workflow example”
Terminal window
# 1. Create a series
veronese series create --title "Interview Series"


# 2. Submit a YouTube video
veronese episode create --series 1 \
  --url "https://youtube.com/watch?v=dQw4w9WgXcQ" \
  --title "Guest Interview"


# 3. Wait for completion
veronese episode poll 42


# 4. Export the transcript
veronese episode export 42 --format md --out interview.md