What is Yeonhong Bot?

Yeonhong Bot is a Discord bot that provides natural TTS (Text-to-Speech) voice reading for your server. Once the bot joins a voice channel, any chat messages typed in the designated text channel are instantly read aloud.

Key Features

🔊 Multilingual TTS

Automatically detects Korean, English, and Japanese and converts each message to the optimal voice for that language.

Language	Voices	Auto-detect
Korean (ko)	7	✅
English (en)	3	✅
Japanese (ja)	3	✅

🎛️ Fine-grained Customization

Each user can personalize their TTS settings:

• Nickname — The name the bot reads before your message (up to 10 characters)
• Voice — Choose a different voice per language
• Pitch — Adjust voice pitch in the -4.0 ~ +4.0 range
• Speed — Adjust speaking speed in the 0.5x ~ 2.0x range

🎵 Custom Soundboard

Register custom audio files per server, and specific keywords typed in chat will automatically trigger playback.

🌐 Real-time Translation

Break language barriers with automatic translation powered by the DeepL API.

Supported translation directions:

• Korean ↔ English
• Korean ↔ Japanese
• English ↔ Japanese

👑 Membership (Custom Voice)

Members can upload their own voice or any audio sample to create a custom TTS voice.

How It Works

User types a message
      ↓
  Text preprocessing
  (URL removal, emoji handling, spam detection)
      ↓
  Language auto-detection
      ↓
  TTS engine called
  (Supertone / MiniMax)
      ↓
  Lavalink audio streaming
      ↓
  Voice channel playback

Voice Channel Required

To use Yeonhong Bot's TTS, you must join a voice channel first. If the bot is not in a voice channel, call it with the /join command.

Automatic Features

Some features work automatically without any commands:

• File attachment announcements — Reads the file type: "photo", "video", "document", etc.
• Forwarded message announcements — Announces that a message was forwarded
• Reply announcements — Reads as "(nickname) replied to (target)"
• Spam detection — Limits consecutive repeated characters
• URL auto-removal — Excludes links from TTS

See the Automatic Features page for details.

Tech Stack

Yeonhong Bot uses the following technologies for reliable service:

• discord.py 2.4+ — Discord bot framework
• Lavalink 5.0+ — High-quality audio streaming
• Supertone / MiniMax TTS — Natural voice synthesis
• MySQL + Redis — Settings storage and caching
• Multi-cluster sharding — Large-scale server support