WuDict (wudict) searches all your local dictionaries at once and shows
the results in the browser at localhost:6888. One
executable, no dependencies; runs on macOS, Linux (including Raspberry Pi),
Windows and Android.
📖 User Guide: wuweidict.github.io/wudict
- Download the binary for your system from
releases, rename it
to
wudict, make it executable (chmod +x wudict) and move it to a folder inPATH, e.g./usr/local/bin.- Windows: the installer
wudict-windows-x64-setup-<version>.exe, orwudict-windows-amd64-cgo.exe. - macOS:
wudict-macos-universal-app-<version>.zipcontains wuDict.app, with a menu-bar icon. It is signed ad hoc: see macOS app for the first launch.
- Windows: the installer
- Run
wudict. The browser opens at localhost:6888. - The default dictionary folder is
~/Dictionaries. If it is missing or empty, the setup page (localhost:6888/setup) sets the folders, and imports dictionaries from a file or a link.
Tip
If you don't have yet a local dictionary collection you can download some FOSS dictionaries from the links here.
- Formats: MDict, StarDict, Aard2, DSL, Babylon, ZIM, wudict markdown (a plain-text dictionary you can write in a text editor)
- Instant search across all dictionaries with four modes: prefix, exact, full-text, and wildcard search (
c?t,*ology,*rain*) - Dictionaries are automatically grouped by language, publisher, direction, or your own custom groups.
- Adjust the font size via the ☰ → +/- widget
- Custom lemmatization (word-form morphology) for 24 languages, configurable via ☰ → ⚙️ → Lemmatization; English lemmatization comes pre-installed
- Browse all headwords in a dictionary via ☰ → Browse
- Apply custom CSS styles and fonts via the embedded Styler: ☰ → ⚙️ → Custom Style
- 📱 Double-tap / 💻 double-click any word in a wudict dictionary article to instantly look up its definition
- 📱 Immersive mode (full screen), with an option to draw content edge-to-edge, including the camera cutout area; enable by long-tapping the wudict icon in the launcher → Settings
- 📱 Select text in any app and pick → wuDict from the context menu
- 📱 Import dictionaries into wudict directly from your file manager: tap a .mdx/.dsl/.bgl/.zim/.slob/.zip/.7z file → Share → wuDict
- 📱 Long-tap a dictionary download link on any web page (.mdx/.slob/.dsl/.zip/.7z) and pick Share → wuDict to install it locally
- Install multiple dictionaries via wudict magic links 🔗
| Format | Files | Notes |
|---|---|---|
| MDict | .mdx + .mdd |
.mdd, .1.mdd, … resource archives; Speex audio decoded |
| StarDict | .ifo + .idx(.gz) + .dict(.dz) |
.syn synonyms; res/ folder or res.zip |
| Aard 2 | .slob |
zlib, bz2, LZMA2 |
| Lingvo DSL | .dsl, .dsl.dz |
.dsl.files.zip resources; UTF-8/16/32 detected |
| Babylon | .bgl |
character sets detected |
| ZIM | .zim, or .zimaa + .zimab + … |
Kiwix and Wikimedia archives; the parts of a split archive are read as one file |
| wudict markdown | .wudict.md, .wudict.md.gz, .md |
Markdown (CommonMark) as generated by wudict dump -format md |
| wudict library | text.db |
wudict's SQLite format, one folder per dictionary |
| Mode | Matches | Needs |
|---|---|---|
| exact | the headword, ignoring case and accents | |
| prefix | headwords that start with the query | |
| wildcard | headwords that fit a pattern: ? is one character, * any number of characters; *rain* finds headwords that contain rain; a capital letter or an accent puts the headwords that have it first |
headword index |
| full-text | words in the article text, ranked by relevance; phrases, AND, OR, NOT, NEAR |
full-text index |
Each dictionary's headwords are indexed in the background on its first search.
The full-text index is added per dictionary in the dictionary panel
(☰), or with wudict ingest -fulltext. With lemma
data, an inflected form finds its lemma: understood → understand.
Tip
- / focuses the search box
- double-click a word in an article to search for it
- ⊞ expands all results, ⇔ widens the layout, ◐ cycles the theme
- the address bar holds the search, so a search can be bookmarked
| Install, First run | download, folders |
| Search, Full-text query syntax, Wildcard syntax | modes, lemmatization, the dictionary panel |
| Add dictionaries, The library | import, indexing, removal |
| Picker groups, Custom styles, Resource overrides | customization |
| Android, macOS, Windows, Run at startup | platforms |
| Access from other devices, Browser extension | network |
| Configuration, Command line, HTTP API, text.db | reference |
Requires Go; the default -cgo build also needs
a C compiler.
make build # ./wudict (cgo SQLite, built-in Speex decoder)
make check # tidy, vet, tests
make cross # -purego binaries for every release platform
make help # every targetWithout make:
go install -tags sqlite_fts5 github.com/wuweidict/wudict@latest # cgo
go install github.com/wuweidict/wudict@latest # pure GoOn Windows, make is available as make-<version>-without-guile-w32-bin.zip
from ezwinports; put
make.exe in a folder in PATH. More: Building.
Almost nothing here was invented by this project. Some of the formats wudict reads are open-source, others are
closed source, and they are available because other people spent years working
on dictionaries and tools to read, write and convert data in these formats.
- pyglossary — its plugins are the clearest working description of
MDX/MDD, StarDict, Slob, DSL and BGL that exists anywhere, and the BGL parser
in
wudictis ported frompyglossary'sbabylon_bglplugin. Thanks to @ilius and pyglossary's contributors for sustained, meticulous work on formats nobody else kept maintaining. - GoldenDict and the actively developed fork goldendict-ng — the program that made these dictionaries worth owning, and the model for the BGL reader's streaming decompression.
- medict by Quan Chen (formerly
go-mdict) — the MDX/MDD parser ininternal/gomdictis derived from it. - Raul Fernandes and Karl Grill — the original reverse engineering of the Babylon BGL format.
- slob and Aard 2 by Igor Tkach, StarDict, ABBYY Lingvo's DSL, and Kiwix's ZIM.
- SQLite and its FTS5 extension — the entire prepared library: storage, headword index, and full-text search across a hundred dictionaries at once. Public domain.
- mattn/go-sqlite3 — cgo SQLite driver; the default optimized build.
- modernc.org/sqlite — SQLite translated to pure Go, so releases build for every platform without a C toolchain. Both drivers are first-class.
- Speex — Jean-Marc Valin and the
Xiph.Org Foundation.
internal/speexvendors the reference decoder so.spxpronunciations play without an external tool, and it includes kiss_fft by Mark Borgerding. - anchore/go-lzo — LZO1X decompression for MDX v1.2 key and record blocks, written from the kernel's format documentation and lzokay by Jack Andersen.
- c0mm4nd/go-ripemd — RIPEMD, for MDX decryption keys.
- cespare/xxhash — the MDX v3 decryption key.
- klauspost/compress — zstd and deflate, for ZIM clusters, Slob bins and MDX blocks.
- pierrec/lz4 — LZ4, for MDX blocks.
- ulikunitz/xz — LZMA, for Slob and ZIM content.
- aaaton/golem — English lemmatiser, so that understood finds understand.
- golang.org/x/net — HTML tokeniser, used to rewrite article markup and resolve dictionary resources.
- gogpu/systray and godbus/dbus — the tray icon, and its Linux desktop integration.
- Inno Setup by Jordan Russell — the Windows installer: small, scriptable, and free for as long as Windows has had installers.
- Go — cross-compiles a static binary for eight platforms, Android included, from one machine.
Not affiliated with, or endorsed by, any of the above.
GPL-3.0-or-later — see LICENSE.
wudict licenses prints the full third-party notices from inside the binary;
the same text is in THIRD-PARTY-NOTICES.md.
Third-party code included in this repository:
| Component | Origin | Licence |
|---|---|---|
internal/gomdict (MDX/MDD parser) |
medict, © 2023 Quan Chen | GPL-3.0-or-later |
internal/format/bgl (BGL parser) |
ported from pyglossary's babylon_bgl |
GPL-3.0-or-later |
internal/speex/clib (Speex decoder) |
Speex, © Jean-Marc Valin / Xiph.Org, Analog Devices | BSD-3-Clause |
internal/speex/clib (kiss_fft) |
kissfft, © Mark Borgerding | BSD-3-Clause |
Dependencies fetched at build time keep their own licenses; every one of them,
with its license text, is listed in
THIRD-PARTY-NOTICES.md (regenerate with
make notices).


