# 🎤 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.

IntroBot

Every entrance deserves a soundtrack. Upload a clip or set a TTS catchphrase — IntroBot hypes you up the second you join voice.

التصويت لـIntroBot

هل ترغب في دعمنا؟