translate

README

Discord Translate bot

A Translate bot using discordgo and Google Translate API.

To translate a message into a given language, react to it with the desired language flag. The source language is automatically detected.

Example

import (
  translate "github.com/StalkR/discordgo-translate"
)

b := translate.New("<bot token>", "<Google Translate API token>")
if err := b.Start(); err != nil {
  log.Fatal(err)
}
defer b.Close()

log.Printf("Discord Translate bot running - press CTRL-C to exit")
sc := make(chan os.Signal, 1)
signal.Notify(sc, syscall.SIGINT, syscall.SIGTERM, os.Interrupt, os.Kill)
<-sc

Acknowledgements

Discord Go bindings: bwmarrin/discordgo (doc).

Inspiration: Smoogle Translate, unfortunately the developers intentionally refuse to translate messages from other bots, so I had to make my own.

Bugs, comments, questions

Create a new issue.

Documentation

Overview

Package translate is a Discord bot library to translate messages with Google Translate API.

import translate "github.com/StalkR/discordgo-translate"

Discord bot setup:

• create a new application: https://discordapp.com/developers/applications/me
• get client ID, required to add bot to server below
• click add bot
• get token, required to configure the bot
• add bot to server: https://discordapp.com/oauth2/authorize?&client_id=CLIENT_ID&scope=bot&permissions=0

Add a Google Translate API key and start the bot.

To translate a message into a given language, react to it with the desired language flag. The source language is automatically detected.

Index

• type Bot
  • func New(token string, apiKey string) *Bot
  • func (b *Bot) Close() error
  • func (b *Bot) Start() error

Examples

• Bot

Types

type Bot

type Bot struct {
	// contains filtered or unexported fields
}

A Bot represents a Discord Translate bot.

Example

b := New("<Discord bot token>", "<Google Translate API token>")
if err := b.Start(); err != nil {
	log.Fatal(err)
}
defer b.Close()

log.Printf("Discord Translate bot running - press CTRL-C to exit")
sc := make(chan os.Signal, 1)
signal.Notify(sc, syscall.SIGINT, syscall.SIGTERM, os.Interrupt, os.Kill)
<-sc

func New

func New(token string, apiKey string) *Bot

New creates a new Discord Translate bot. Requires a Discord bot token and a Google Translate API key.

func (*Bot) Close

func (b *Bot) Close() error

Close closes the bot: handler uninstalled and Discord session closed. Bot can be started again.

func (*Bot) Start

func (b *Bot) Start() error

Start starts the bot, connecting it to Discord.