veronese CLI

Audio transcription, terminal speed

Veronese
in your
terminal

veronese gives you a direct CLI for ingesting audio, managing series, and exporting transcripts — all without leaving your terminal.

Install Now Open Veronese

Works with YouTube, podcast URLs, and direct audio uploads.

$ curl -fsSL https://cli.veronesebook.com/install.sh | sh
$ veronese config set-url https://veronesebook.com
$ veronese config set-token tok_abc123
$ veronese status
$ veronese episode create --series abc123 \
    --url https://youtube.com/watch?v=dQw4w9WgXcQ
$ veronese episode poll ep_xyz789
$ veronese episode export ep_xyz789 --format md

Install

One command install with checksum verification.

curl (macOS & Linux)

curl -fsSL https://cli.veronesebook.com/install.sh | sh

Supports macOS and Linux (amd64/arm64). Installs to /usr/local/bin.

Homebrew

brew tap adusingi/veronese
brew install adusingi/veronese/veronese

Recommended for macOS. Enables brew upgrade veronese later.

Verify

veronese version

Confirms the binary is on your PATH and working.

Quickstart

From install to exported transcript in four steps.

  1. Configure your instance

    veronese config set-url https://veronesebook.com
veronese config set-token <your-api-token>
veronese config show

    Get your API token from veronesebook.com/api_access_tokens.

  2. Check your workspace

    veronese status

    Shows your balance (free + paid seconds), series count, and recent activity.

  3. Create an episode

    veronese series list
veronese episode create \
  --series <series-id> \
  --url https://youtube.com/watch?v=...

    Accepts YouTube URLs, podcast feeds, X/Twitter links, or direct audio files.

  4. Poll and export

    veronese episode poll <episode-id>
veronese episode export <episode-id> --format md

    Poll waits until transcription completes, then export saves the result as Markdown or plain text.

Core Commands

Full lifecycle management with script-friendly --json output.

Config

veronese config set-url <url>
veronese config set-token <token>
veronese config show

Status

veronese status
veronese status --json

Series

veronese series list
veronese series create --title "My Podcast"
veronese series show <id>
veronese series delete <id> --yes

Episode

veronese episode create --series <id> --url <url>
veronese episode show <id> --json
veronese episode poll <id> --max-wait 600
veronese episode export <id> --format md --out out.md
veronese episode events <id>
veronese episode retry <id>
veronese episode delete <id> --yes

Token

veronese token list
veronese token create --name "ci"
veronese token revoke <id> --yes

Troubleshooting

Most common first-run issues.

config not found / authentication required

Run veronese config set-url https://veronesebook.com and veronese config set-token <token>, then verify with veronese config show.

not enough seconds / insufficient balance

Top up your balance at veronesebook.com/billing. Check current balance with veronese status.

episode failed

Run veronese episode events <id> to see the full lifecycle log, then veronese episode retry <id> to re-queue.

command not found after install

Add /usr/local/bin to your PATH: export PATH="/usr/local/bin:$PATH" in your shell profile, then restart your terminal.

Veronese App GitHub Releases API Tokens