TTSBuddy CLI demo

Turn terminal text, Markdown files, and readable webpages into MP3 audio from a shell. This no-signup demo uses fixed samples so you can test the CLI without handing over an email address.

Sign up for TTS Buddy Open in GitHub Codespaces CLI source and releases CLI docs
Demo boundary: demo mode accepts only the fixed sample files and one public docs URL below. It returns pregenerated MP3 files from this site. Real use supports your own text, webpages, voices, and language options with a TTS Buddy API key.

One-minute terminal path

Install the CLI, point it at the constrained demo endpoint, then run any sample command.

brew install ngelik/tap/ttsbuddy

export TTSBUDDY_API_URL=https://www.ttsbuddy.com/v1/cli-demo
export TTSBUDDY_API_KEY=ttsb_demo_cli

The prebuilt demo audio uses Madison, a premium American English voice, at 1.0x speed. If Homebrew is not available, use Codespaces or install from the GitHub release binary.

Copy-paste recipes

Incident handoff to MP3

Useful when the next person on-call needs a quick spoken summary.

curl -fsSLO https://www.ttsbuddy.com/cli-demo/oncall-summary.md
ttsbuddy speak -f oncall-summary.md --voice af_heart --speed 1 -o oncall-summary.mp3

Release notes as JSON

Exercise the API-compatible response shape for scripts.

curl -fsSLO https://www.ttsbuddy.com/cli-demo/release-notes.md
ttsbuddy speak -f release-notes.md --voice af_heart --speed 1 --json

Public docs page to a URL

The CLI extracts readable page text, then demo mode returns the fixed docs MP3.

ttsbuddy web https://www.ttsbuddy.com/docs/developers/cli --voice af_heart --speed 1 --no-download

Raw MP3 stdout

For shell pipelines. The redirect writes MP3 bytes directly.

ttsbuddy speak -f oncall-summary.md --voice af_heart --speed 1 -o - > oncall-summary.mp3

Codespaces demo

The Codespaces kit in the CLI repo opens with the demo endpoint configured and sample files ready. The first useful command should be copy-pasteable once the terminal is ready.

Video

The page leads with commands so you can try the workflow directly. The short video is here as a backup walkthrough.

Switching to real mode: sign up for TTS Buddy, unset TTSBUDDY_API_URL, create an API key, and run ttsbuddy config set key <your-key>. Real mode supports arbitrary text, 300+ voices, 30+ language modes, and 500,000-character requests.