🍵 차 Cha for Korean

A delightfully refreshing Discord bot for searching and translating Korean.

About

CHA-KO is the Korean Discord bot that delivers language and dictionary information to students, travelers, and kpop/kdrama enthusiasts alike.

Korean, with its unique alphabet, is a fascinating language that draws learners from around the world. However, the journey to fluency can be challenging. Learners often struggle with understanding the language's structure, pronunciation, Hanja, and the cultural nuances inherent to Korean.

CHA-KO is a unified turnkey solution for searching dictionary sources, displaying Hangul Romanization, word definitions/origins, and links to relevant external sources.

CHA-KO uses data from public sources including the National Institute of Korean Language's Korean-English Basic Learners' Dictionary.

Getting Started

For Users

Public bot hosted by Thyme Dev.

For Bot Owners, Self-hosters

You can also install the Red DiscordBot cog, self-host this bot only, or join the Discord for updates and news!

Krdict API

A Krdict API is optional, but recommended.

Adds fallback using official content XML API, when the web parser breaks/fails/doesn't return any results.

Note: All content is in Korean. Official South Korean (Republic of Korea) government site.

• Homepage: https://krdict.korean.go.kr/openApi/openApiInfo
• Apply for API Key: https://krdict.korean.go.kr/openApi/openApiRegister
  1. Click the first box, this is the Copyright Policy, accept the terms and continue.
  2. Enter your email address in the text box, and click the button next to it.
  3. You will receive a confirmation email with your API key!

Red Discord Bot Owners: Type this in a Discord DM with your bot:

• [p]set api krdict api_key,YOURAPIKEYHERE

Self-host kodict-dpy: After you've copied .env.example to .env, edit your .env file with:

• krdict_api_key="YOURAPIKEYHERE"

DeepL API

A DeepL API is optional, but recommended. Only the Free API is supported.

Adds built-in translation fallback when Krdict API and parsers don't return any results.

• Homepage: https://www.deepl.com/en/pro-api
  • Register for the free API

When you're done:

Red Discord Bot Owners: Type this in a Discord DM with your bot:

• [p]set api deepl api_key,YOURAPIKEYHERE

Self-host kodict-dpy: After you've copied .env.example to .env, edit your .env file with:

• deepl_api_key="YOURAPIKEYHERE"

Features

• Search dictionary entries in Korean (Hangul, Hanja)

• Search dictionary entries in English

• Pronunciation in Hangul and Romanization

• Word origins in Hanja

• Parts of speech

Commands

• [p]kodict : Searches Korean dictionary
• [p]kosearch : Searches Korean translation services