Raycast Easydict

Easily look up words or translate text.

🇨🇳 🇺🇸 🇯🇵 🇰🇷 🇫🇷 🇪🇸 🇵🇹 🇮🇹 🇷🇺 🇩🇪 🇸🇦 🇸🇪 🇳🇱 🇷🇴 🇹🇭 🇸🇰 🇭🇺 🇬🇷 🇩🇰 🇫🇮 🇵🇱 🇨🇿 🇹🇷 🇱🇹 🇱🇻 🇺🇦 🇧🇬 🇮🇩 🇲🇾 🇸🇮 🇪🇪 🇻🇳 🇮🇷 🇵🇰 🇹🇱 🇹🇦 🇮🇳 🇵🇭 🇫🇮 🇰🇭 🇱🇦 🇧🇳 🇲🇲 🇳🇴 🇷🇸 🇭🇷 🇲🇳 🇮🇱

Originally developed by tisfeng, currently maintained by maxchang3.

💡 Looking for the native macOS app? Check out the standalone Easydict App!

Easydict is a concise and easy-to-use translation dictionary macOS App that allows you to easily and elegantly look up words or translate text, feel free to try it!

Look up word	Translate text

OCR screenshot translate	Auto select translate

What is Raycast Easydict? 【中文介绍】

Easydict is a simple and easy-to-use dictionary app for looking up words and translating text. It works out of the box, automatically detects the input language, and supports Linguee and Youdao Dictionary for dictionary lookup.

For translation, it supports OpenAI, macOS System Translation, DeepL, Google Translate, Bing Translator, Baidu Translate, Tencent Translate, Volcano Engine Translation, Youdao Translate, and Caiyun Translate.

Installation

This is an extension of Raycast, so you need to install Raycast first.

Raycast is a blazingly fast, totally extendable launcher. Similar to Alfred but it's completely free!

Install from Raycast Store

Manually Install

git clone https://github.com/tisfeng/Raycast-Easydict.git && cd Raycast-Easydict

npm install && npm run dev

Features

• 🆕 Support Raycast for Windows (most features are adapted).
• Works out of the box for easily looking up words or translating text.
• Automatically detects input languages and queries your preferred target language.
• Provides rich query information, including basic translations, pronunciations, exam coverage, parts of speech, tenses, and web phrases.
• Automatically queries selected text (enabled by default).
• Supports screenshot OCR translation.
• Supports opening the Eudic Dictionary for quick lookups (if installed on your Mac).
• Supports automatic audio playback of word pronunciations (use Cmd + S to play manually).
• Supports Youdao Text-to-Speech (TTS).
• Supports manually sorting query results.
• Supports Arguments.
• Supports Fallback Commands.
• Supports system proxies.
• Supports Linguee and Youdao Dictionary.
• Supports macOS System Translation. (Please see How to use 🍎 macOS system translation in Easydict?)
• Supports OpenAI, Gemini, DeepL, Google, Bing, Baidu, Tencent, Volcano, Youdao, and Caiyun translation.
• Supports 48+ languages.

If you like this extension, please give it a Star ⭐️, thanks!

Screenshots

Arguments

Dictionary Details

Youdao Modern Chinese Dict

Linguee Dictionary

English <--> Chinese	English <--> French

Show More Details（Shortcut Cmd + M）

Translation Results

Configuration

Easydict works well out of the box. The following options help you customize its behavior.

Preferred Languages

The default preferred languages are simplified Chinese and English. You can change them according to your preferences.

Preference language has two main functions:

First, it improves the accuracy of automatic detection of input text language.

Preference language will be given priority in order during automatic detection. This is because some words may represent multiple languages at the same time, and the automatic detection program cannot work as expected. In most cases, the automatic detection of input text is very useful, except for very few special cases. For example, the English word heel will be automatically recognized into Dutch by Youdao translation, and then the translation results are not what we expect. At this time, if your Easydict preferred language contains English, it will be recognized into English first and translated correctly.

Second, it is used to confirm your target translation language.

For example, if you input a sentence arbitrarily, it will be translated into the first preferred language. If the automatically recognized language is the same as your first preferred language, it will be automatically translated into the second preferred language.

Automatic Query Selected Text

Automatic query selected text of the frontmost application, this option is turned on by default.

In order to better match the automatic selected text feature, it is a good idea to set a hotkey for Easydict, such as Cmd + E, so that after selected the text, you can directly query words through the hotkey, which is very smooth and elegant.

Automatic Play Query Word Pronunciation

Automatically play the word audio after querying the word, turned on by default.

Note that when this option is started, the voice will be played only when the query is judged to be is_Word and in English, e.g. good, look for, etc. For other queries, the voice can be played with the shortcut Cmd + S.

The content of playing voice: English words are pronounced by the online Youdao dictionary first, and other words are pronounced by the TTS service of Youdao translation. For long text playback, use the say command.

Use Cmd + S to play the pronunciation of words manually.

Select Target Language

Specify the target language. This option is turned off by default.

By default, the extension will automatically select the preferred language as the target translation language. However, sometimes if you want to manually specify a language as the target language, you can turn on this option in the preferences and then you can temporarily select another target language in the action panel.

Sort Query Results Manually

You can sort query results by your preference, default is Youao Dictionary, Linguee Dictionary, OpenAI, Gemini, DeepL, Google, Bing, Apple, Baidu, Tencent, Volcano, Youdao, Caiyun.

Name case are insensitive, use comma to separate. Example: youdao dictionary, linguee dictionary, openai, gemini, deepl, google, bing, apple, baidu, tencent, volcano, youdao, caiyun. You can also specify a part of the sort, for example: youdao dictionary, apple, tencent，the actual sort is: youdao dictionary, apple, tencent, linguee dictionary, openai, gemini, deepl, google, bing, baidu, volcano, youdao, caiyun.

Note: This sort is the overall sort, if a translation service is not enabled, the sort will be automatically ignored.

🍎 Apple Translate

Easydict support MacOS system translate, for more information, please see How to use macOS Apple System Translation in Easydict?

System Proxy

Easydict supports system proxy. To use it, turn on Use System Proxy Settings in the Raycast extension settings. When enabled, all network requests will be sent through the system proxy. This is useful for services that require a proxy (e.g., Google Translate in China) or for counter IP blocking (some services such as Linguee have frequency restrictions on IPs). Enabling proxy may slow down response time, so please enable it only when needed.

Supported Languages

Currently we support 49 languages: Simplified Chinese, Traditional Chinese, English, Japanese, Korean, French, Spanish, Portuguese, Italian, German, Russian, Arabic, Swedish, Romanian, Thai, Slovak, Dutch, Hungarian, Greek, Danish, Finnish, Polish, Czech, Turkish, Lithuanian, Latvian, Ukrainian, Bulgarian, Indonesian, Malay, Slovenian, Estonian, Vietnamese, Persian, Hindi, Telugu, Tamil, Urdu, Filipino, Khmer, Lao, Bangla, Burmese, Norwegian, Georgian, Serbian, Croatian, Mongolian, Hebrew.

Language Detection

Easydict uses four remote language detection services: Bing, Baidu, Tencent, and Volcano. Franc provides the local fallback.

Bing and Baidu language detection are enabled by default. Tencent and Volcano can be enabled independently in preferences and require their corresponding credentials. In general, enabling more detection services can improve accuracy and response time.

Details of the languages supported by each language detection service are as follows:

Languages	Bing	Baidu	Volcano	Tencent
Simplified Chinese	✅	✅	✅	✅
Traditional Chinese	✅	✅	✅	❌
English	✅	✅	✅	✅
Japanese	✅	✅	✅	✅
Korean	✅	✅	✅	✅
French	✅	✅	✅	✅
Spanish	✅	✅	✅	✅
Portuguese	✅	✅	✅	✅
Italian	✅	✅	✅	✅
German	✅	✅	✅	✅
Russian	✅	✅	✅	✅
Arabic	✅	✅	✅	❌
Swedish	✅	✅	✅	❌
Romanian	✅	✅	✅	❌
Thai	✅	✅	✅	✅
Slovak	✅	✅	✅	❌
Dutch	✅	✅	✅	❌
Hungarian	✅	✅	✅	❌
Greek	✅	✅	✅	❌
Danish	✅	✅	✅	❌
Finnish	✅	✅	✅	❌
Polish	✅	✅	✅	❌
Czech	✅	✅	✅	❌
Turkish	✅	✅	✅	✅
Lithuanian	✅	✅	✅	❌
Latvian	✅	✅	✅	❌
Ukrainian	✅	✅	✅	❌
Bulgarian	✅	✅	✅	❌
Indonesian	✅	✅	✅	✅
Malay	✅	✅	✅	✅
Slovenian	✅	✅	✅	❌
Estonian	✅	✅	✅	❌
Vietnamese	✅	✅	✅	✅
Persian	✅	✅	✅	❌
Hindi	✅	✅	✅	❌
Telugu	✅	✅	✅	❌
Tamil	✅	✅	✅	❌
Urdu	✅	✅	✅	❌
Filipino	✅	✅	✅	❌
Khmer	✅	✅	✅	❌
Lao	✅	✅	✅	❌
Bangla	✅	✅	✅	❌
Burmese	✅	✅	✅	❌
Norwegian	✅	✅	✅	❌
Georgian	✅	✅	✅	❌
Serbian	✅	✅	✅	❌
Croatian	✅	✅	✅	❌
Mongolian	✅	✅	✅	❌
Hebrew	✅	✅	✅	❌

Dictionary

Youdao Dictionary

Support 5 languages, (Chinese), English, French, Japanese, Korean.

Linguee Dictionary

Support 19 languages, (Chinese, Japanese, Russian), English, French, Spanish, Portuguese, Italian, German, Swedish, Romanian, Slovak, Dutch, Hungarian, Greek, Danish, Finnish, Polish, Czech.

Translation

Currently, we support OpenAI, Gemini, DeepL, Google, Bing, 🍎 Apple, Baidu, Tencent, Volcano, Youdao, and Caiyun translation, total 11 translation services.

Google and DeepL translations support system proxy. To enable proxy, turn on Use System Proxy Settings in the Raycast extension settings. (DeepL works without a proxy, but sometimes requests time out)

Note ⚠️: Google Translate China site (translate.google.cn) is currently unavailable. You can only use the international version (translate.google.com), so you may need to enable a proxy to use Google Translate.

Supported translation languages:

Languages	Youdao	DeepL	Google	Bing	🍎 Apple	Baidu	Volcano	Tencent	Caiyun
Simplified Chinese	✅	✅	✅	✅	✅	✅	✅	✅	✅
Traditional Chinese	✅	✅	✅	✅	✅	✅	✅	✅	❌
English	✅	✅	✅	✅	✅	✅	✅	✅	✅
Japanese	✅	✅	✅	✅	✅	✅	✅	✅	✅
Korean	✅	✅	✅	✅	✅	✅	✅	✅	❌
French	✅	✅	✅	✅	✅	✅	✅	✅	❌
Spanish	✅	✅	✅	✅	✅	✅	✅	✅	❌
Portuguese	✅	✅	✅	✅	✅	✅	✅	✅	❌
Italian	✅	✅	✅	✅	✅	✅	✅	✅	❌
German	✅	✅	✅	✅	✅	✅	✅	✅	❌
Russian	✅	✅	✅	✅	✅	✅	✅	✅	❌
Arabic	✅	✅	✅	✅	✅	✅	✅	✅	❌
Swedish	✅	✅	✅	✅	❌	✅	✅	❌	❌
Romanian	✅	✅	✅	✅	❌	✅	✅	❌	❌
Thai	✅	❌	✅	✅	✅	✅	✅	✅	❌
Slovak	✅	✅	✅	✅	❌	✅	✅	❌	❌
Dutch	✅	✅	✅	✅	✅	✅	✅	❌	❌
Hungarian	✅	✅	✅	✅	❌	✅	✅	❌	❌
Greek	✅	✅	✅	✅	❌	✅	✅	❌	❌
Danish	✅	✅	✅	✅	❌	✅	✅	❌	❌
Finnish	✅	✅	✅	✅	❌	✅	✅	❌	❌
Polish	✅	✅	✅	✅	✅	✅	✅	❌	❌
Czech	✅	✅	✅	✅	❌	✅	✅	❌	❌
Turkish	✅	✅	✅	✅	✅	✅	✅	✅	❌
Lithuanian	✅	✅	✅	✅	❌	✅	✅	❌	❌
Latvian	✅	✅	✅	✅	❌	✅	✅	❌	❌
Ukrainian	✅	✅	✅	✅	✅	✅	✅	❌	❌
Bulgarian	✅	✅	✅	✅	❌	✅	✅	❌	❌
Indonesian	✅	✅	✅	✅	✅	✅	✅	✅	❌
Malay	✅	❌	✅	✅	❌	✅	✅	✅	❌
Slovenian	✅	✅	✅	✅	❌	✅	✅	❌	❌
Estonian	✅	✅	✅	✅	❌	✅	✅	❌	❌
Vietnamese	✅	❌	✅	✅	✅	✅	✅	✅	❌
Persian	✅	❌	✅	✅	❌	✅	✅	❌	❌
Hindi	✅	❌	✅	✅	❌	✅	✅	✅	❌
Telugu	✅	❌	✅	✅	❌	✅	✅	❌	❌
Tamil	✅	❌	✅	✅	❌	✅	✅	❌	❌
Urdu	✅	❌	✅	✅	❌	✅	✅	❌	❌
Filipino	✅	❌	✅	✅	❌	✅	✅	❌	❌
Khmer	✅	❌	✅	✅	❌	✅	✅	❌	❌
Lao	✅	❌	✅	✅	❌	✅	✅	❌	❌
Bangla	✅	❌	✅	✅	❌	✅	✅	❌	❌
Burmese	✅	❌	✅	✅	❌	✅	✅	❌	❌
Norwegian	✅	✅	✅	✅	❌	✅	✅	❌	❌
Georgian	✅	❌	✅	✅	❌	✅	✅	❌	❌
Serbian	✅	❌	✅	✅	❌	✅	✅	❌	❌
Croatian	✅	❌	✅	✅	❌	✅	✅	❌	❌
Mongolian	✅	❌	✅	✅	❌	✅	✅	❌	❌
Hebrew	✅	❌	✅	✅	❌	✅	✅	❌	❌

Translation Services Setup

For ease of use, we provide built-in API credentials (AppID and AppKey) for translation services. However, these shared services have rate limits. If too many users access them simultaneously, responses may slow down or fail. Therefore, for the best experience, we highly recommend applying for your own dedicated API credentials and updating them in the Preferences page.

Don't worry, these services offer generous free tiers that are more than enough for personal use.

The following tutorial (from Bob) will guide you through the application process step by step.

• Youdao Translate： Select text translation and speech synthesis. (You will receive ¥50 experience fund)
• Baidu Translate
• Tencent Translate
• Volcano Translate
• Caiyun Translate
• DeepL

Integrations

PopClip

You need to install PopClip first, then add a shortcut key for Easydict, such as Cmd + E, then you can open Easydict quickly with PopClip!

Usage: Select the following code block, PopClip will show "Install Easydict", just click it.

  # popclip
  name: Easydict
  icon: search E
  key combo: command E

Ref: https://github.com/pilotmoon/PopClip-Extensions#extension-snippets-examples

Acknowledgements

• This project was inspired by raycast-Parrot and Bob, and its initial version was based on raycast-Parrot. Easydict improves upon the original project by refining the UI, adding practical new features, removing overly complex operations, and heavily optimizing performance.
• The OCR Translate feature is based on ScreenOCR. Special thanks to aidevjoe for the PR: feat: add OCR recognition.