Easydict README

The project's README from github.com/tisfeng/Easydict. As one markdown file: README.md.

Easydict

Easy to look up words or translate text

License Downloads macOS

中文   |   English

Easydict

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.

Easydict is ready to use out of the box, can automatically recognize the language of the input text, supports input translate, select translate, and OCR screenshot translate, and can query multiple translation services results at the same time.

Supported services: 20+ dictionary, translation, AI, local-model, and CLI services, including Apple Dictionary, MDict, Apple Translate, OpenAI, Gemini, Claude, DeepSeek, Ollama, Claude Code, Codex CLI, DeepL, Google, and Bing. See the services overview for the complete list and access requirements.

Log

immerse-1686534718.gif

Features

If you like this app, please consider giving it a Star ⭐️, thanks! (^-^)

Contributing

Contributions through issues and pull requests are welcome. Read the Chinese contribution guide for the development workflow and pull request requirements.

AI Coding

We welcome contributions assisted by programming agents such as Codex and Claude. Prefer the latest available GPT or Claude model suitable for complex coding tasks, and carefully review and test the final changes. See the Chinese contribution guide for the Agent workflow and review requirements.

Issue/PR Triage Notes

The maintainer has been quite busy recently and usually only has time to triage issues on weekends. PRs (especially bugfix PRs) are prioritized. Also, due to an overloaded inbox and notifications, some messages may not be seen or replied to promptly. Thanks for your understanding.

Installation

brew install --cask easydict

Manual Installation

Download the latest release.

[!NOTE] Latest version supports macOS 13.0+, for older systems please use 2.7.2


Usage

Ways Description Preview
Input Translate Press the input translate shortcut key (default ⌥ + A), enter the text to be translated, and Enter key to translate iShot_2023-01-20_11.28.46-1674185354
Mouse Select Translate The query icon is automatically displayed after the word is selected, and the mouse hovers over it to query iShot_2023-01-20_11.01.35-1674183779
Shortcut Select Translate After selecting the text to be translated, press the shortcut key (default ⌥ + D) iShot_2023-01-20_11.24.37-1674185125
Screenshot Translate Press the screenshot translate shortcut key (default ⌥ + S) to capture the area to be translated iShot_2023-01-20_11.26.25-1674185209
Silent Screenshot OCR Press the Silent Screenshot shortcut key(default ⌥ + ⇧ + S)to capture the area, the OCR results will be copied directly to the clipboard 屏幕录制 2023-05-20 22 39 11

Documentation


Acknowledgements

Statement

Easydict is licensed under the GPL-3.0 open source license, which is for learning and communication only. Anyone can get this product and source code for free. If you believe that your legal rights have been violated, please contact the author immediately. You can use the source code freely, but you must attach the corresponding license and copyright.

Sponsor

Easydict is a free and open source project, currently mainly developed and maintained by the author. If you like this project and find it helpful, you can consider sponsoring this project to support it, so that it can go further.

Thanks to @CanglongCl for providing the Apple Developer account, which solved the app signature issue, allowing more people to use Easydict conveniently.

Thanks to all sponsors for their generous support. For details, please see the Sponsor List.


Star History

Star History Chart

Easydict (tisfeng/Easydict)

Searching Database…

What is this?Easydict is a macOS app for looking up word definitions and translating text, pulling results from multiple dictionary and translation services at once.
Is this a dictionary or a translator?Both at once: it queries 20+ dictionary, translation, AI and local-model services simultaneously and shows their results side by side.
Which translation services do I need accounts for?None are required to start since Apple Dictionary and Apple Translate work out of the box, but to use services like OpenAI, Gemini, Claude, DeepSeek or DeepL you need their respective API keys.
How responsive is the maintainer to issues?The maintainer is busy and mostly triages issues on weekends, with bugfix PRs getting priority; some messages may go unanswered promptly.
Does it work on older macOS versions?The current release needs macOS 13.0 or later; people on older systems should stick to the older 2.7.2 release.
How do I trigger a translation without opening the app window?You can use shortcuts: press the default Option+A for input translate, Option+D after selecting text, Option+S for screenshot translate, or Option+Shift+S for silent screenshot OCR that copies results straight to the clipboard.
Does it support OCR for translating screenshots?Yes, it has both a screenshot translate mode and a silent screenshot OCR mode that copies recognized text directly to the clipboard.
What inspired Easydict?It was inspired by saladict and Bob, with the initial version built on Bob (GPL-3.0), and many of its features and UI elements are referenced from Bob.
How many languages can it translate between?Easydict supports 52 selectable translation languages.
Creator
tisfeng
Size
172.6 MB
Stars
15K
Age
3y
Commits · 90 Days