Kepler Dictionary Plugin

A Kepler plugin that lets you look up words across multiple dictionaries without leaving your keyboard.

What it does

Type /dict in Kepler to open the dictionary search mode, then enter any word to query your enabled dictionary sources simultaneously.

Supported sources:

Each result shows the source as a badge and opens the full dictionary entry in your browser when selected.

When no query has been entered yet, the search mode shows how many sources are currently active.

Unhealthy sources

Sources are queried in parallel, and results can only be shown once every one of them has answered — so a source whose host hangs would otherwise stall the entire lookup until the runtime's ~10s fetch timeout, long enough that Kepler gives up and shows nothing.

To prevent that, a source that fails is skipped for 10 minutes before being tried again. An outage therefore costs one slow query rather than breaking lookups for as long as it lasts. Paused sources are named on the search mode's status line, and a word simply not being in a dictionary (HTTP 404) counts as a miss, not a failure.

Installation

Requirements: Node.js and pnpm

git clone https://github.com/zFlxw/kepler-dictionary.git
cd kepler-dictionary
pnpm install
pnpm build

The build step bundles the plugin and writes it to:

~/Library/Application Support/Kepler/Plugins/flxws-kepler-dictionary.keplugin/

Then in Kepler:

1. Open Settings → Plugins
2. Enable Community Plugins if not already active
3. The Dictionary plugin should appear in the list — enable it
4. Use /dict or type dictionary in the global search to open it

After any code change, run pnpm build again and reload the plugin in Kepler.

Configuration

In the plugin settings you can toggle each source on or off individually:

• Enable Duden — on by default
• Enable DWDS — on by default
• Enable Wiktionary (English) — on by default