Skip to content

About

Easy to look up words or translate text. Windows port of tisfeng/Easydict.

Resources

Stars

126 stars

Watchers

1 watching

Forks

Repository files navigation

Easydict for Windows

Easy to look up words or translate text

A Windows port of Easydict

English   |   中文

Table of Contents

Introduction

This is a Windows port of Easydict, originally a macOS translation dictionary app. Easydict for Windows brings translation, dictionary lookup, and text tools together with quick keyboard shortcuts and flexible windows.

Back to Top

Screenshots

Overview

Main Window with Mini Window (Quick Translate)

Main Window All Windows Settings
Main Window All Windows Settings
Full translation interface Main + Mini + Fixed windows with hotkey settings Service configuration

Light & Dark Mode

Light & Dark Mode — Mini Window (Quick Translate)

Grammar Correction Dictionary Mode Long Document Translation
Grammar Correction Dictionary Mode Long Document Translation
AI-powered grammar correction Word definitions, phonetics, and examples PDF/Text/Markdown translation with progress
OCR Screenshot Translate Mouse Selection Translate
OCR Screenshot Translate Mouse Selection Translate
Capture screen region → OCR → translate Select text in any app → click to translate

Back to Top

Features

  • Microsoft Copilot+ Copilot+ PC and local AI — NPU-accelerated translation on Copilot+ PCs, with Foundry Local available on other Windows PCs.

  • OCR Screenshot Translate

    • Ctrl+Alt+S — Capture a screen region, recognize the text, and translate it.
    • Ctrl+Alt+Shift+S — Recognize the text and copy it to the clipboard without translating.
  • Mouse Selection — Select text in any app, then click the floating button to translate it.

  • Text Action — Send selected text to a translation or search service from any window.

  • Bob plugin compatibility — Install .bobplugin translation plugins from the Bob ecosystem and use them as translation services.

  • Labs — New feature, start in Settings -> Labs.

  • Hover Word Lookup — Hold Ctrl for at least 50 ms, then hover over a word to look it up.

  • Grammar Correction Mode

  • AI Provider Profiles and Magpie Magpie

  • Long Document Translation - Translate PDF, plain text, and Markdown documents with ML-based layout detection, formula protection, parallel processing, bilingual output, and translation cache

  • Dictionary Mode — Look up word definitions, phonetics, and examples.

  • MDX Dictionary — Import MDict (.mdx) dictionaries for offline lookup.

  • Direction Mode

  • Global Hotkeys

    • Ctrl+Alt+T - Show/hide main window
    • Ctrl+Alt+D - Translate clipboard content
    • Ctrl+Alt+M - Show/hide mini window (copies selection and translates when available)
    • Ctrl+Alt+F - Show/hide fixed window
    • Ctrl+Alt+S - OCR screenshot translate
    • Ctrl+Alt+Shift+S - Silent OCR (copy recognized text to clipboard)
    • Ctrl+Alt+Shift+M - Toggle mini window visibility
    • Ctrl+Alt+Shift+F - Toggle fixed window visibility
  • Multiple Window Mode

    • Main Window - Full translation interface
    • Mini Window - Compact floating window
    • Fixed Window - Persistent translation window
  • Streaming Translation — See results as they arrive.

  • Dark Mode Theme

  • TTS — Read the source and translated text aloud.

  • Multi-language UI — Use the interface in 15 languages.

  • 40+ Languages — Choose which languages appear in the source and target lists.

  • HTTP Proxy Support

  • High DPI Support

  • Multi-pair Translation Services

Google Translate and Google Dictionary
Google Translate
Google Dictionary
Bing Translate
Bing
DeepL
DeepL
Youdao
Youdao
OpenAI
OpenAI
Gemini
Gemini
DeepSeek
DeepSeek
Groq
Groq
Zhipu AI
Zhipu AI
Kimi
Kimi
GitHub Models
GitHub Models
Doubao
Doubao
Volcano Engine
Volcano Engine
Caiyun
Caiyun
NiuTrans
NiuTrans
Linguee (currently unavailable)
Linguee*
Ollama
Ollama
Windows Local AI
Windows Local AI
OpenRouter
OpenRouter
OrcaRouter
OrcaRouter
Powered by OrcaRouter
Magpie
Magpie
Custom OpenAI-compatible
Custom OpenAI
Claude Code
Claude Code
Codex
Codex

Linguee is currently unavailable.

Back to Top

Installation

System Requirements

  • Windows 10 version 2004 (build 19041) or later
  • x64 or ARM64 processor

Install via winget

winget install xiaocang.EasydictforWindows

Download

Download from the Releases page.

Portable Version (Recommended)

File: easydict_win32-vX.Y.Z-x64.zip

  • No installation required - extract and run
  • No administrator privileges needed
  • Self-contained (.NET runtime included)
  • First run may trigger Windows SmartScreen warning - click "More info" → "Run anyway"
# Extract and run
Expand-Archive easydict_win32-v1.0.0-x64.zip -DestinationPath Easydict
.\Easydict\Easydict.WinUI.exe

Verify Download (Optional)

Each release includes SHA256 checksums for verification.

# Linux/macOS/WSL
sha256sum -c checksums-x64.sha256 --ignore-missing

# PowerShell
$expected = (Get-Content checksums-x64.sha256 | Select-String "easydict_win32").ToString().Split()[0]
$actual = (Get-FileHash easydict_win32-v1.0.0-x64.zip -Algorithm SHA256).Hash.ToLower()
if ($expected -eq $actual) { "OK" } else { "FAILED" }

Build from Source

# Clone repository
git clone https://github.com/xiaocang/easydict_win32.git
cd easydict_win32/dotnet

# Build
dotnet build src/Easydict.WinUI/Easydict.WinUI.csproj -c Release

# Run
dotnet run --project src/Easydict.WinUI/Easydict.WinUI.csproj

Back to Top

Tech Stack

  • .NET - Runtime framework
  • WinUI 3 (Windows App SDK) - Modern Windows UI framework
  • C# - Programming language
  • xUnit + FluentAssertions - Unit testing

Back to Top

Translation Service Integration Tests

Service Protocol Status Notes
Google Translate REST ✅ Free, no API key
Bing Translate REST ✅ Free, no API key
Youdao REST ✅ Web + OpenAPI
OpenAI OpenAI API ✅
DeepSeek OpenAI API ✅
Gemini Gemini API ✅ Custom SSE streaming
Zhipu AI OpenAI API — Temporarily skipped: no API key configured
Kimi OpenAI API — OpenAI-compatible (Moonshot AI), missing API key
Volcano Engine REST ✅ HMAC-SHA256 signing
Groq OpenAI API ✅ OpenAI-compatible
GitHub Models OpenAI API — OpenAI-compatible, missing API key
Doubao Custom SSE — Missing API key
DeepL REST ✅ Free/Pro API
Caiyun REST — Missing API key
NiuTrans REST ✅
Linguee REST — Unavailable: upstream sample API domain no longer resolves; integration tests are skipped by default
Google Dict REST ✅
Ollama OpenAI API — Requires local Ollama setup
Windows Local AI Local runtime ✅ TranslationManager routing tested; real inference requires Phi Silica, Foundry Local, or OpenVINO model
OpenRouter OpenAI API — OpenAI-compatible, missing API key
OrcaRouter OpenAI API ✅ Integration coverage: streaming translation, non-streaming translation, and live model catalog (free models first)
Custom OpenAI OpenAI API — OpenAI-compatible, user-defined endpoint
Magpie OpenAI-compatible gateway ✅ 32 focused offline checks and isolated synthetic-gateway UI review; no real gateway or model call
Claude Code Local CLI (stream-json) — Requires local claude CLI signed in
Codex Local CLI (JSONL) — Requires local codex CLI signed in

Services marked OpenAI API extend BaseOpenAIService and share the same OpenAI-compatible implementation, so untested ones are expected to work similarly.

Back to Top

Support the Project

If Easydict for Windows is useful to you, please give the repository a star on GitHub. Your support helps more people discover the project and motivates its continued development.

Back to Top

Comparison with macOS Version

Feature macOS Windows
Translation Services 25+ 20
OCR Screenshot Translation Yes Yes
TTS Yes Yes
Selection Translation Yes Yes
Hover Word Lookup No Yes (disabled by default)
Grammar Correction No Yes
Long Document Translation No Yes
Dictionary Mode Yes Yes
Window Types 3 3
Global Hotkeys 10+ 8
LLM Streaming Yes Yes
Traditional Chinese Yes Yes

Back to Top

Comparison with pdf2zh

pdf2zh (PDFMathTranslate) is a popular open-source PDF translation tool focused on scientific papers. The table below compares the long document translation capabilities of the two.

Feature pdf2zh Easydict Win32
Layout Detection DocLayout-YOLO ONNX (DocLayout-YOLO) / Vision LLM / Heuristic / Auto
Formula Protection LaTeX preservation Three-tier detection, multi-font glyph rendering, subscript/superscript handling
LLM Backends OpenAI, Ollama, Azure OpenAI, etc. OpenAI, Gemini, DeepSeek, Groq, Zhipu, Kimi, GitHub Models, Doubao, Ollama, Custom OpenAI-compatible
Document Context Pass No Yes — glossary + summary + preservation hints extracted before block translation for terminology consistency
Translation Cache No Yes — SQLite cache keyed by source hash + service + language pair
Parallel Translation Limited Configurable concurrency with retry + quality feedback
OCR Fallback (Scanned PDF) No Yes — Windows OCR for image-only pages
CJK Font Handling Basic Built-in CJK font resolver + TrueType CMAP parser + automatic font download
Page Range Selection Yes Yes (1-3,5,7-10 or all)
UI CLI + minimal GUI Native WinUI 3 app with progress, preview, cancellation
Integration Standalone Part of full translation dictionary app (OCR, selection, hotkeys, streaming, etc.)
Platform Cross-platform (Python) Windows 10/11 (native .NET 8)

Back to Top

License

GPL-3.0 - For learning and communication purposes only. License and copyright notice must be included when using source code.

Back to Top

Acknowledgements


This project was developed using Vibe Coding, with AI-assisted programming by Claude (Anthropic).

About

Easy to look up words or translate text. Windows port of tisfeng/Easydict.

Resources

Stars

126 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

⌂ 换网址