Skip to content
Veronese Docs

Troubleshooting

command not found: veronese

Section titled “command not found: veronese”

The veronese binary is not on your system PATH.

Terminal window
# Add the install directory to your PATH (add to ~/.zshrc or ~/.bashrc)
export PATH="/usr/local/bin:$PATH"


# Reload your shell
source ~/.zshrc   # or ~/.bashrc

Then verify:

Terminal window
veronese version

config not found

Section titled “config not found”

The CLI cannot find your configuration file.

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

Get your token from veronesebook.com/api_access_tokens.

not enough seconds

Section titled “not enough seconds”

Your account has insufficient transcription credits.

Terminal window
# Check your current balance
veronese status

Then visit veronesebook.com/billing to top up.

Episode stuck in ingesting or transcribing

Section titled “Episode stuck in ingesting or transcribing”

The episode may still be processing. Try polling with a longer timeout:

Terminal window
veronese episode poll <id> --max-wait 600

If it stays stuck for more than 10 minutes, check the event log:

Terminal window
veronese episode events <id>

episode failed

Section titled “episode failed”

The transcription encountered an error. Inspect the event log and retry:

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


# Retry the failed episode
veronese episode retry <id>

Common causes:

  • The URL was inaccessible or required authentication
  • The audio file was corrupted or too short
  • Insufficient credit balance at time of processing

Still stuck?

Section titled “Still stuck?”