cast — Typecast TTS CLI (v1.0.2)#

Quick start#

bash

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#

bash

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

presetmodelnormal / happy / sad / angryssfm-v21, ssfm-v30whisper / toneup / tonedownssfm-v30 only

Intensity: 0.0–2.0 (default 1.0)

bash

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#

flagdefaultdescription--voice-idtc_60e5426de8b95f1d3000d7b5voice ID--modelssfm-v30ssfm-v30 (37 langs, 7 presets + smart) / ssfm-v21 (27 langs, 4 presets, low latency)--languageauto-detectedISO 639-3 code (e.g. kor, eng, vie, jpn, fra)--tempo1.0speed (0.5–2.0)--pitch0pitch (–12 ~ +12 semitones)--volume100loudness (0–200)--out—output file path--formatwavwav / mp3--seedrandomreproducibility key

Recipes#

bash

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#

bash

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):

VariableFlagTYPECAST_API_KEY``--api-key``TYPECAST_VOICE_ID``--voice-id``TYPECAST_MODEL``--model``TYPECAST_LANGUAGE``--language``TYPECAST_EMOTION``--emotion``TYPECAST_EMOTION_PRESET``--emotion-preset``TYPECAST_EMOTION_INTENSITY``--emotion-intensity``TYPECAST_FORMAT``--format``TYPECAST_VOLUME``--volume``TYPECAST_PITCH``--pitch``TYPECAST_TEMPO``--tempo