Audio to text transcription

Transcribe audio from your terminal

A powerful CLI for the Veronese audio-to-text application. Convert podcasts, YouTube videos, and audio files to text with simple commands.

$ curl -fsSL https://cli.veronesebook.com/install.sh | sh
Get Started Visit Veronese

Installation

Install the Veronese CLI with a single command. Choose the method that works best for your system.

bash 
# Download and install veronese
curl -fsSL https://cli.veronesebook.com/install.sh | sh

# Verify installation
veronese version

Quickstart

Go from installation to your first transcript in 5 steps.

Step 1

Configure the CLI

Set your API endpoint and authentication token. Get your token from the Veronese dashboard.

bash 
# Set the API URL
veronese config set-url https://veronesebook.com

# Set your API token (get one at veronesebook.com/api_access_tokens)
veronese config set-token YOUR_API_TOKEN

# Verify your configuration
veronese config show
Step 2

Create a series

Organize your transcriptions into series. A series is a collection of related episodes.

bash 
# Create a new series
veronese series create --title "My Podcast"

# List all your series
veronese series list
Step 3

Add an episode

Create an episode from any audio or video URL. YouTube, direct audio links, and more are supported.

bash 
# Create an episode from a YouTube video
veronese episode create --series 1 --url https://youtube.com/watch?v=dQw4w9WgXcQ

# Or from any audio URL
veronese episode create --series 1 --url https://example.com/podcast.mp3
Step 4

Wait for processing

Transcription happens in the cloud. Poll the episode status until it completes.

bash 
# Poll until the episode is ready (default 5 min timeout)
veronese episode poll 42

# Or set a custom timeout
veronese episode poll 42 --max-wait 600
Step 5

Export your transcript

Download the completed transcript in your preferred format.

bash 
# Export as markdown
veronese episode export 42 --format md --out transcript.md

# Or view the episode details
veronese episode show 42 --json

Command Reference

Complete reference for all Veronese CLI commands. All commands accept --json for script-friendly output.

config set-url Set the API endpoint URL 
veronese config set-url https://veronesebook.com
config set-token Set your API authentication token 
veronese config set-token <token>
config show Display current configuration 
veronese config show
status Check account status and remaining credits 
veronese status

Troubleshooting

Common issues and their solutions. If you encounter a problem not listed here, check the GitHub issues or open a new one.

config not found

The CLI cannot find your configuration file.

Solution: Run the configuration commands to set up your API endpoint and token.

veronese config set-url https://veronesebook.com
veronese config set-token YOUR_API_TOKEN
not enough seconds

Your account has insufficient transcription credits.

Solution: Top up your balance in the Veronese dashboard and verify with the status command.

# Check your current balance
veronese status

# Then visit veronesebook.com/billing to add more credits
episode failed

The episode transcription process encountered an error.

Solution: Check the episode events to diagnose the issue, then retry the transcription.

# View processing events to diagnose the issue
veronese episode events <id>

# Retry the failed episode
veronese episode retry <id>
command not found: veronese

The veronese binary is not in your system PATH.

Solution: Add the installation directory to your PATH environment variable.

# Add to your shell profile (.bashrc, .zshrc, etc.)
export PATH="/usr/local/bin:$PATH"

# Then reload your shell
source ~/.zshrc  # or ~/.bashrc

Need more help?

Check out these resources for additional support.

GitHub Repository Issue Tracker Veronese Dashboard