🎤 How to Use 1337 TTS Bot

Complete guide to getting started with text-to-speech in your Discord server

1
Adding the Bot to Your Server

First, you need to invite the bot to your Discord server:

  1. Click the "Add to Server" button on the dashboard or use this link:
  2. Select the server where you want to add the bot
  3. Review the requested permissions (the bot needs these to function properly)
  4. Click "Authorize" to complete the setup
⚠️ Important: Make sure you have "Manage Server" permissions to add bots to your Discord server.
2
Joining Voice Channels

The bot automatically connects to voice channels when needed:

  • Automatic Connection: Join any voice channel in your server
  • Smart Detection: The bot will automatically join when you send a message in the matching text channel
  • Channel Priority: The bot respects other TTS bots and avoids conflicts
💡 Pro Tip: Make sure you're in a voice channel before sending TTS messages for the best experience!
3
Using Text-to-Speech

Start using TTS with multiple convenient methods:

📝 Basic Usage

  • Standard Method: Join any voice channel, then type in the corresponding text channel
  • Target Channel TTS: Type anywhere and specify which voice channel to play in (if enabled by admins)
  • Automatic Connection: The bot intelligently joins your voice channel when you send TTS messages
  • Smart Queue: Messages are queued and played in order, with intelligent conflict resolution
Example: Join "General" voice channel, then type "Hello everyone!" in the "general" text channel

🧠 Smart Voice Text Detection

The bot uses intelligent detection to monitor your messages:

  • Automatic Channel Matching: Messages in the text channel matching your voice channel name
  • Real-time Processing: Instant text-to-speech conversion when you type
  • Voice Channel Requirement: You must be in a voice channel for TTS to work
  • Smart Filtering: Only processes messages from users actually in voice channels
4
Voice Selection & Customization

Choose from 200+ premium Google Cloud TTS voices with advanced selection tools:

🎵 Interactive Voice Browser

/tts-menu

Opens a sophisticated voice selection interface with organized categories:

  • 👨 Male Voices: Professional, natural-sounding male voices
  • 👩 Female Voices: Expressive, clear female voices
  • 🌍 International: 40+ languages and regional accents

🎤 Voice Testing & Discovery

Preview voices before selection with our interactive voice browser:

  • Web Preview: Test all 200+ voices online with your own custom text
  • Live Testing: Real-time voice samples generated in the browser
  • Smart Filtering: Filter by gender, language, and search by name
  • Quality Assurance: High-quality Google Cloud TTS synthesis
🎤 Try Voice Samples: Test all 200+ voices online with your own text before choosing! Use the copy button to get voice IDs instantly.

🔧 Direct Voice Setting

/setvoice voice:en-US-Standard-A

After testing voices on our voice samples page, use the 📋 Copy button to get the exact voice ID for the /setvoice command. This allows for instant voice changes without navigating through menus.

💡 Pro Tip: Use the voice selection in /tts-menu to browse and test different voices, or visit the voice samples page for advanced testing with custom text!
5
Personal Preferences

Customize your personal TTS experience with comprehensive settings:

👤 Access Your Settings

/tts-menu

Opens the TTS menu where you can view and change all your personal settings including voice, nickname, and preferences.

🏷️ Custom Nickname

Set a custom nickname through the TTS menu for personalized announcements instead of your Discord username.

🔇 TTS Control

Enable or disable TTS for your messages through the menu settings while keeping your voice preferences saved.

🔄 Reset Everything

Reset all your preferences back to default settings through the TTS menu reset option.

💡 Privacy Note: Your preferences are stored securely and only apply to your Discord account.
6
Server Administration

Comprehensive server management tools for administrators:

⚙️ Basic Server Settings

/tts-menu

Access the complete server administration panel through the admin menu with these options:

  • enable/disable: Turn TTS on/off for the entire server
  • settings: View current server configuration
  • reset: Reset all settings to defaults

🎛️ Advanced Configuration

Fine-tune your server's TTS experience:

  • maxlength: Set message character limits (50-1000)
  • volume: Adjust server audio volume (0.1-1.0)
  • queue-limit: Control message queue size (5-50)
  • rate-limit: Set per-user message limits (1-20/min)
  • default-voice: Set default voice for new users

🎯 Target Channel TTS

Enable cross-channel TTS through the admin menu settings to allow users to send TTS to any voice channel from anywhere in the server.

🤖 Priority Bot Management

Manage bot conflicts and priority systems:

  • list: View current priority bot whitelist
  • add: Add bots to avoid conflicts with
  • remove: Remove bots from priority list

📋 Text Processing Options

  • abbreviations: Toggle automatic abbreviation expansion
  • username-prefix: Include usernames in TTS announcements
⚠️ Admin Only: These commands require "Manage Server" permissions in Discord.
Advanced Features

Discover the powerful features that make this TTS bot exceptional:

📊
Real-Time Dashboard
/dashboard
Monitor bot activity, server statistics, and usage analytics with live WebSocket updates.
🎯
Target Channel TTS
Send TTS messages to any voice channel from anywhere in your server when enabled by admins.
🧠
Smart Queue Management
Intelligent message queuing with conflict resolution and priority bot detection.
🔄
Auto-Reconnection
Seamless reconnection after bot restarts with voice channel restoration.
🌐
Multi-Language Support
40+ languages with regional accents powered by Google Cloud TTS.
📈
Analytics & Tracking
Comprehensive usage statistics, voice change tracking, and server analytics.
🛡️
Bot Conflict Management
Priority bot detection and intelligent conflict avoidance for seamless operation.
High Performance
PostgreSQL backend, optimized queue processing, and real-time WebSocket updates.
📜
Complete Commands List

Reference guide for all available commands:

👤 User Commands

  • /tts-menu - Main TTS menu with voice selection and settings
  • /setvoice - Set voice directly with voice ID
    💡 Find voice IDs easily on our voice samples page
  • /dashboard - Open real-time bot dashboard
  • /donate - Support bot development

🛠️ Admin Commands

  • /tts-menu - Access admin settings through the smart menu system
  • • enable/disable - Server TTS toggle
  • • settings - View current configuration
  • • reset - Reset to defaults
  • • maxlength - Set character limits
  • • volume - Adjust audio volume
  • • queue-limit - Message queue size
  • • rate-limit - Per-user message limits
  • • default-voice - Set default voice
  • • target-channel-tts - Enable cross-channel TTS
  • • priority-bots - Manage bot conflicts
  • • abbreviations - Toggle text expansion
  • • username-prefix - Username announcements
💡 Command Permissions: User commands work for everyone, Admin commands require "Manage Server" permissions.
🔧
Troubleshooting

Common issues and solutions:

🔇 Bot Not Speaking

  • Check Voice Channel: Make sure you're in a voice channel
  • Check Permissions: Bot needs "Connect" and "Speak" permissions
  • Server Settings: Verify TTS is enabled through /tts-menu admin settings
  • User Settings: Check your TTS settings with /tts-menu

❌ Command Errors

  • Permissions: Admin commands require "Manage Server" permissions
  • Voice Issues: Use /tts-menu to browse valid voice options
  • Rate Limits: Wait if you're sending messages too quickly

🤖 Bot Conflicts

  • Priority Bots: Bot may defer to higher priority TTS bots
  • Admin Solution: Use /tts-menu admin settings to manage priority bots
  • Multiple Bots: Only one TTS bot should be active per channel

📞 Getting Help

  • Dashboard: Use the Dashboard to check bot status
  • Settings Check: Use /tts-menu to check user and admin settings
  • Bot Status: Check if bot is online and has proper permissions
💡 Quick Fix: Most issues are resolved by checking voice channel connection and bot permissions!