DumTranslator

A powerful Discord bot that automatically translates messages and provides real-time voice captions!

Screenshot Showcase

Key Features

Automatic Message Translation

• Language Detection: Currently checks for Arabic and Korean characters (may be modified to detect more in the future)
• Multiple Translation Backends: Choose from 3 different translation services
• Interactive Backend Selection: Optionally switch translation providers on-the-fly with dropdown menus

Real-Time Voice Captions

• Live Speech-to-Text: Transcribes voice chat conversations in real-time
• Multi-User Support: Shows who's speaking with usernames/nicknames
• Powered by Groq: Uses whisper-large-v3 for transcription and translation

Flexible Configuration

• Channel Management: Use /translate to turn translations on or off per channel
• Backend Customization: Set config defaults for new channels and override backend/dropdown settings per channel
• Resource Efficient: Written in Go for minimal resource usage

Translation Backends

AI-Powered (Prompted):

• Cerebras
• Mistral
• ArliAI (currently disabled in code due to unreliable uptime)

Direct API:

• TranslateAPI
• MyMemory

For API key setup, refer to each service's documentation.

Commands

Translation Control

• /translate - Show this channel's translation status and defaults
• /translate enabled:on - Enable translations in the current channel using saved or config-default settings
• /translate enabled:on backend:TranslateAPI interaction_selection:off - Enable or update this channel with a specific backend and dropdown preference
• /translate enabled:off - Disable translations in the current channel while keeping its saved settings

Voice Captions

• /captions on - Start real-time captions in your voice channel
• /captions off - Stop captions and leave voice channel

Setup

Prerequisites

1. Go 1.22+: Install Go
2. C/C++ Build Tools: Required for TEN-VAD and Opus decoding (CGO).
   • Ubuntu/Debian: sudo apt-get install gcc build-essential libopus-dev libc++-dev libc++abi-dev
3. Discord Bot Token: Create at Discord Developer Portal
4. API Keys: Get keys for your preferred translation services

Installation

1. Clone this repository

2. Build the bot:

   go build ./cmd/bot

3. Create config.json (copy from config.example.json) and add your keys:

   {
     "discord_token": "YOUR_DISCORD_BOT_TOKEN",
     "translate_api_key": "YOUR_TRANSLATEAPI_KEY",
     "cerebras_api_key": "YOUR_CEREBRAS_API_KEY",
     "cerebras_model": "gpt-oss-120b",
     "mistral_api_key": "YOUR_MISTRAL_API_KEY",
     "mistral_model": "mistral-large-latest",
     "groq_api_key": "YOUR_GROQ_API_KEY",
     "mymemory_email": "YOUR_EMAIL@example.com",
     "backend": "TranslateAPI",
     "interaction_select_enabled": true,
     "target_channels": []
   }

Invite the Bot

Replace YOUR_CLIENT_ID with your bot's Application ID:

https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=536873984&scope=bot

Required Permissions:

• Manage Webhooks
• View Channels
• Send Messages

Usage

Start the bot:

./bot -config config.json

Quick Start Guide

1. Invite the bot to your server
2. Use /translate enabled:on in any channel to enable translations
3. Arabic and Korean messages will be automatically translated to English
4. If the channel has interaction selection enabled, use the dropdown menu on translated messages to try different backends
5. For voice chats, use /captions on in the voice channel chat to enable live transcription

Advanced Features

Backend Selection

Each translated message can include a dropdown menu to instantly re-translate using different backends. Set interaction_select_enabled in config for new channels, or override it per channel with /translate.

Cost Optimization

The bot only processes Arabic and Korean messages, saving API costs by skipping English and other languages.

Voice Caption Customization

Captions show speaker names, support multiple users, and maintain conversation history for context.

Development

Run locally:

go run ./cmd/bot/main.go

Notes

• Voice captions require captions_enabled: true in config
• backend and interaction_select_enabled in config.json act as defaults for newly enabled channels
• Channel preferences persist between bot restarts
• Language detection can be modified to support additional languages

---

Built with Go and DiscordGo | GitHub