screencastgen

VoiceSettings

Bundled/custom voice picker with preview.

Source: web/frontend/src/components/VoiceSettings.tsx

---

Props

{
  config: HighlightConfig | AudioConfig
  onChange: (config: Partial<HighlightConfig>) => void
  uploadedFileId?: string | null
}

---

Features

Voice Source Toggle

• Bundled — Select from pre-installed voices
• Custom — Upload reference audio clip

Bundled Voice Picker

• Fetches voice list from listVoices()
• Displays available voices with language tags
• Audio preview playback
• Auto-selects first available voice

Custom Voice Upload

• FileUploader for reference audio
• Uploaded reference audio is transcribed internally when the pipeline job runs

Additional Controls

• Language selector — from listLanguages()
• Voice preview — Generate TTS sample via previewVoice()
• Document-aware preview — Passes uploadedFileId so the preview endpoint can use a snippet from the user’s document when supported

---

State

State	Type	Description
voices	BundledVoice[]	Available voices
languages	LanguageOption[]	Available languages
loadError	string \| null	Voice/language loading error
voiceSource	"bundled" \| "upload"	Selected source
uploadedRefName	string \| null	Uploaded custom voice filename
previewLoading	boolean	Preview generation in progress
previewError	string \| null	Preview error
previewUrl	string \| null	Blob URL for preview audio

---

Used By

• NewJob Page — When pipeline is highlight

---

See Also

• Voices API — API client
• Voices Router — Backend endpoints
• Voices Service — Voice manifest
• LipsyncSettings — Alternative for lipsync pipeline

This site is open source. Improve this page.