// Guide
TeamSpeak TTS Bridge
Connect a TeamSpeak server to Discord and have its text chat spoken aloud in a Discord voice channel with selectable AI voices.
The TeamSpeak TTS Bridge is for orgs that live in both worlds: StarBot connects to your TeamSpeak server over ServerQuery, watches its text chat, and speaks those messages aloud in a Discord voice channel using AI text-to-speech. Discord members sitting in the linked voice channel hear what's being typed on TeamSpeak — no alt-tabbing, no second client.
The bridge requires an Elite subscription — every /teamspeak-tts subcommand except credits is Elite-gated. Elite includes a monthly TTS credit allowance; see Credits below.
Everything is configured in Discord with the /teamspeak-ttsadminElite command (there is no dashboard card for this feature). The command is admin-only.
Setup
You'll need ServerQuery credentials for your TeamSpeak server: the host, a ServerQuery username and password, and — if they differ from the defaults — the query port (default 10011) and server port (default 9987).
- 1Connect to TeamSpeak. Run
/teamspeak-tts setup host: username: password: [query_port:] [server_port:]with your ServerQuery credentials. The bot connects and stays connected — it also auto-reconnects to saved servers after a restart. - 2Link a Discord voice channel. Run
/teamspeak-tts link voice_channel:and pick the Discord voice channel where speech should play. The bot joins it and starts speaking TeamSpeak text chat. - 3Position the bot on TeamSpeak. Run
/teamspeak-tts channelsto list your TeamSpeak channels with their IDs, then/teamspeak-tts move channel:to place the bot where your members chat. The bridge also follows activity, moving toward where TeamSpeak users are. - 4Tune the voice. Pick a voice with
/teamspeak-tts voiceand adjust pacing with/teamspeak-tts speed(0.25–4.0, default 1.0). Check everything with/teamspeak-tts status.
teamspeak-tts setup host:ts.myorg.space username:serveradmin password:•••••••• query_port:10011 server_port:9987Subcommands at a glance
setup— connect to a TeamSpeak server (host, ServerQuery username/password, optional ports).link voice_channel:— choose the Discord voice channel for TTS playback.unlink— disconnect the bridge.move channel:— move the bot to a specific TeamSpeak channel (name or ID).channels— list all TeamSpeak channels and their IDs.voice— change the TTS voice (see table below).speed— speech speed multiplier, 0.25–4.0 (default 1.0).credits— view your TTS credit balance and usage (works without Elite).status— connection status for the bridge.
Voices
| Voice | Character | | --- | --- | | Nova | Energetic and friendly | | Alloy | Neutral and balanced | | Echo | Clear and professional | | Fable | Warm and expressive | | Onyx | Deep and authoritative | | Shimmer | Soft and conversational |
Credits
Speech generation costs TTS credits, metered by characters spoken. Elite includes $1.50 of TTS credits per month; credits reset monthly and unused credits do not roll over. Check your balance any time:
teamspeak-tts creditsWhen the balance runs low, the embed adds a warning with a link to purchase additional TTS credits through the bot's Discord store page. credits is the one subcommand that works without Elite, so you can always check where you stand.
Troubleshooting
Setup fails to connect — verify the host and that ServerQuery is enabled on your TeamSpeak server, and double-check the query port (10011 by default — this is not the voice port). ServerQuery credentials are separate from your normal TeamSpeak login.
Nothing is spoken in Discord — confirm a voice channel is linked (/teamspeak-tts status), the bot has permission to join and speak in it, and the bot is sitting in the right TeamSpeak channel (channels + move). Also check credits — an exhausted balance stops speech until the monthly reset or a top-up.
Speech is too fast or slow — /teamspeak-tts speed accepts 0.25 (quarter speed) through 4.0 (quadruple speed); 1.0 is normal.
Related
- Voice Relay — Pro-tier Discord-to-Discord voice tooling.
- Command reference — the full
/teamspeak-ttsentry.