🎤 IntroBot — Give Every Member Their Grand Entrance

Tired of silent voice channels? IntroBot turns every "user joined" moment into a personalized hype event. The second someone hops into voice, the bot swoops in, plays their custom intro, and quietly disappears. It’s like having a personal hype-man for every member of your server.

Whether it’s a 5-second guitar riff, a meme sound, or a robotic voice yelling "A wild Steve appeared!" — IntroBot makes sure no entrance goes unnoticed.

---

✨ Why You'll Love It

🎵 Personal Audio Intros — Each user uploads their own .mp3, .wav, .ogg, or .webm clip. 🗣️ Text-to-Speech Phrases — Don't have an audio file? Just type a phrase and IntroBot will say it out loud in 20+ languages (English, Spanish, French, German, Japanese, Korean, Chinese, Russian, Arabic, Hindi, and many more). 🎲 Built-in Funny Defaults — Members without a custom intro still get a random hilarious one-liner like "Plot twist: {name} actually showed up!" — no setup required. ⚙️ Admin Superpowers — Server owners can set cooldowns, max duration, playback volume, and even register custom default phrases for their whole community. 🌍 Multi-Language TTS — Powered by Google's TTS engine with full validation, so invalid language codes are caught instantly with helpful suggestions. 🛡️ Spam-Proof — Configurable per-user cooldown (default 60s) prevents rapid-fire join abuse. 🚀 Zero Config to Start — Invite the bot, run /intro set-phrase "Hello world!", and you're done. That's it.

---

🎬 How It Works

1. Set your intro with one of two commands:
   • /intro set — upload an audio file (max 2MB, auto-trimmed to 30s)
   • /intro set-phrase "Hello everyone!" — set a TTS phrase in any supported language
2. Join any voice channel in the server.
3. The bot joins, plays your intro, and leaves. Magic. ✨

No need to manage files, no broken links, no fuss. Files are processed server-side with ffmpeg, automatically trimmed, and capped at the server-configured max duration.

---

📜 Commands

👤 User Commands

Command	What it does
/intro set	Upload an audio file as your intro
/intro set-phrase	Set a text-to-speech phrase (with language support)
/intro info	View your current intro setup
/intro remove	Delete your intro
/help	Full command reference & supported languages

🔧 Admin Commands (requires Manage Server)

Command	What it does
/settings cooldown <seconds>	Set per-user cooldown (5–600s)
/settings volume <percent>	Set playback volume (10–200%)
/settings max-duration <seconds>	Cap intro length (3–30s)
/settings sentence-preset <set>	Choose default fallback (Classic funny / Short english)
/settings phrases add <phrase> [lang]	Register a custom default phrase (use {name} for the user's name)
/settings phrases list / remove / reset	Manage custom default phrases
/settings view	View current server config

---

🌍 Supported TTS Languages

en English · es Spanish · fr French · de German · it Italian · pt Portuguese · ja Japanese · zh Chinese · ko Korean · ru Russian · ar Arabic · hi Hindi · th Thai · vi Vietnamese · id Indonesian · pl Polish · tr Turkish · nl Dutch · sv Swedish · da Danish — and many more!

---

🔒 Privacy & Permissions

IntroBot only needs Connect, Speak, and Use Voice Activity permissions. It does not read messages, member lists, or any private data — it only listens for voice-channel join events and plays back the audio you've configured.

Audio files are stored privately per-server and per-user, and are automatically deleted when you remove your intro or upload a replacement.

---

🚀 Get Started

1. Click Invite above to add IntroBot to your server.
2. Run /intro set-phrase "I'm here!" or /intro set with an audio file.
3. Hop into a voice channel and enjoy your grand entrance. 🎉

Tip for admins: run /settings view to see your defaults, then customize cooldown and volume to fit your community vibe.

---

Made with ❤️ for Discord communities that deserve a soundtrack.