cast — Typecast TTS CLI (v1.0.2)

Quick start

cast "Hello!"                                # play immediately
cast "Hello" --out hello.mp3 --format mp3   # save to file
cast "I can't believe it!" --emotion smart  # AI emotion inference

Voices

cast voices pick                            # interactive voice picker
cast voices tournament                      # head-to-head voice selection
cast voices tournament --gender female --size 16  # filtered tournament
cast voices random                          # random voice
cast voices list                            # list all voices
cast voices list --gender female
cast voices list --age young_adult
cast voices list --model ssfm-v30
cast voices list --use-case Audiobook
cast voices get <voice_id>                  # voice details
cast config set voice-id <tc_xxx>           # set default voice

Use-cases: Announcer, Anime, Audiobook, Conversational, Documentary, E-learning, Rapper, Game, Tiktok/Reels, News, Podcast, Voicemail, Ads

Voice picker keys: P=preview, E=preview with smart emotion, S=set default, C=copy ID, Enter=confirm, Esc=back

Emotions

• --emotion smart — AI infers emotion from text (ssfm-v30 only)
• --emotion preset --emotion-preset <preset> — explicit preset

Intensity: 0.0–2.0 (default 1.0)

cast "I'm so happy!" --emotion preset --emotion-preset happy --emotion-intensity 1.5
cast "I just got promoted!" --emotion smart \
  --prev-text "I worked so hard." --next-text "Let's celebrate!"

Key flags

Recipes

echo "System ready." | cast                         # pipe input
curl -s https://example.com/text.txt | cast          # pipe from URL
cast "$(cat script.txt)"                             # read from file
cast "Hello!" --out /tmp/hi.mp3 --format mp3         # save as mp3
cast "Hello" --tempo 1.2 --pitch 2 --emotion preset --emotion-preset happy
cast "Bonjour" --language fra                        # multilingual
cast "Text" --seed 42 --out file.wav                 # reproducible

Auth / config

cast login                   # interactive prompt
cast login <api_key>         # save API key
cast logout                  # remove credentials
cast config list             # show current config
cast config set model ssfm-v21
cast config unset model      # remove a setting

Config file: ~/.typecast/config.yaml

Priority: CLI flags > env vars > config file > defaults

Env vars (TYPECAST_ prefix):