calibre E-book Viewer Dictionary Lookup Not Working: How to Fix It

When calibre’s E-book viewer lets you select a word but dictionary lookup produces no result, opens the wrong provider, shows the wrong language, or fails to launch a web page, the problem usually falls into one of five categories: text selection, lookup source configuration, book language metadata, network access, or the source e-book itself. The steps below isolate each category without deleting your library, reconverting every book, or changing unrelated calibre settings.

This guide focuses specifically on lookup tools in calibre’s desktop E-book viewer. Device dictionaries, the Content server’s browser-based reader, the book editor’s spell checker, and dictionary features built into Kindle, Kobo, or other reading devices are separate systems. A fix for one does not necessarily affect another.

1. Confirm the Symptom With a Small Safe Test

Begin by identifying exactly where the lookup process stops. This prevents a network problem from being mistaken for a damaged book or a selection problem from being mistaken for a broken dictionary provider.

1.1 Test Selected Text Behavior

Open the affected book in calibre’s E-book viewer and double-click an ordinary word in the main text. On a touchscreen, long-press the word. A selection bar should appear near the selected text. Choose the lookup button, which is represented by a library-style icon in the standard viewer interface.

You can also show or hide the word lookup panel with Ctrl+L. If double-clicking selects an entire paragraph, image, footnote marker, or unrelated text, the immediate problem is selection rather than online lookup.

Use a simple word such as house, water, or example. Avoid a hyphenated term, name, abbreviation, apostrophe, line-broken word, or word containing unusual punctuation during the first test.

Success means that the viewer selects only the intended word and sends that word to the lookup panel. Once this works, stop changing selection-related settings and continue only if no useful definition appears.

1.2 Compare Lookup With Copy and Search

Copy the selected word and paste it into a plain-text editor. Then search for the same word inside the book with Ctrl+F. These tests establish whether the visible page contains real text.

• If copying produces the correct word, the viewer has usable text and lookup should be possible.
• If copying produces scrambled characters, missing letters, or unrelated symbols, the e-book’s text encoding or internal markup may be defective.
• If no text can be selected, the page may be an image, as commonly occurs in scanned PDFs.
• If search cannot find a clearly visible word, the displayed content may not have a normal searchable text layer.

Dictionary lookup cannot reliably interpret words that exist only as pixels. Optical character recognition must be performed with an appropriate external workflow before image-only pages become searchable text. Do not convert or overwrite the original file merely to test this possibility.

1.3 Test a Plain English EPUB

Open a known-good, non-DRM EPUB containing ordinary English text. It can be a public-domain EPUB or a small EPUB you already know works correctly. Select a common word and try a built-in lookup source.

This is the most useful dividing test. If lookup works in the plain EPUB but not in the original book, the original file, its language information, or its markup is responsible. If both books fail in the same way, investigate provider settings, network access, browser behavior, or calibre’s configuration.

2. Check Lookup Providers and Language Settings

calibre’s viewer includes lookup sources and allows custom sources based on URL templates. A custom source can fail because its web address changed, its word placeholder is missing, or it is restricted to a language that does not match the current book.

2.1 Test a Built-In Source First

Open the lookup panel and try more than one built-in source. Do not assume that calibre itself is malfunctioning because a single provider returns an empty page, blocks automated requests, changes its website, or lacks an entry for a particular word.

If one source works and another does not, calibre’s selection and network path are functioning. Stop changing global calibre settings. The remaining issue is specific to the failing provider, so use a working source or review that provider’s configuration.

2.2 Review Custom Lookup Sources

In the lookup panel, open the source-management controls. A custom source needs a valid name and a URL template containing {word}. At lookup time, calibre replaces that placeholder with the selected word.

For example, a provider must expose a predictable per-word address. Pasting a dictionary’s home page without the placeholder usually opens the site but does not search for the selected word.

Check the following:

• The address begins with a valid https:// or, for a trusted local service, http:// URL.
• The template contains {word} exactly where the selected word belongs.
• The provider still supports direct word URLs.
• No quotation marks, spaces, or copied formatting were accidentally added.
• The source is not restricted to the wrong book language.

Test the provider’s resulting address in a normal browser using a simple word. If the address fails there too, editing calibre repeatedly will not fix it. Replace the source or wait for the provider to restore service.

2.3 Correct the Book’s Language Metadata

Lookup sources can be limited to specific book languages. Incorrect or missing language metadata may therefore hide an appropriate source or select one intended for another language.

Return to calibre’s main library window, select the book, and press E to open Edit metadata. Check the Languages field and set it to the language of the main text. Save the change, close the existing viewer window, and reopen the book from the library.

For an EPUB containing more than one language, its internal HTML can also use language attributes on individual passages. Library-level metadata is still the sensible first correction for a normal single-language book. Editing internal markup is unnecessary unless the book is genuinely multilingual or incorrectly authored.

Success means that the expected language-specific lookup source appears and returns an appropriate result. Once it does, do not reconvert the book or modify unrelated metadata.

3. Check Internet, Proxy, Firewall, and Browser Handoff

Most standard online lookup providers require an internet connection. A browser may work normally while calibre is blocked by a proxy configuration, security product, DNS filter, certificate inspection system, or application-specific firewall rule.

3.1 Separate Offline and Online Failures

Open an ordinary secure website in your default browser, then test the lookup provider’s website directly. If neither loads, restore the internet connection before troubleshooting calibre.

If the browser works but every online source in calibre fails, check whether a VPN, work network, school network, parental-control tool, DNS filter, or antivirus web shield is treating calibre differently from the browser. Temporarily switching to another trusted network, such as a personal hotspot, can be a useful comparison test.

Success on the second network indicates a network policy or filtering problem. Re-enable normal protections after the test and create only the narrow exception required for calibre. Do not disable the firewall or antivirus permanently.

3.2 Check calibre’s Proxy Information

calibre normally uses the operating system’s proxy settings. The current proxies recognized by calibre can be viewed under Preferences and Miscellaneous. If those values are unexpected, correct the operating system’s proxy configuration or ask the network administrator for the required HTTP and HTTPS proxy details.

Advanced users can supply http_proxy and https_proxy environment variables. This should be done only when the network actually requires a proxy and the correct values are known. Random proxy addresses can break lookup and other internet-dependent calibre features.

If lookup works after correcting the proxy, stop there. Conversion options, library maintenance, device settings, email accounts, and Content server ports are unrelated to this symptom.

3.3 Test Browser Handoff

Some lookup actions or custom sources may hand a URL to the operating system’s browser. If clicking a source does nothing, copy its test URL and open it manually. Then verify that the operating system has a working default browser for HTTP and HTTPS links.

• On Windows, check the default applications assigned to HTTP, HTTPS, and web links.
• On macOS, confirm the default web browser in system settings.
• On Linux, confirm that the desktop environment can open an HTTPS link from another application.

If the browser opens but displays a login page, consent screen, regional block, bot check, or subscription notice, calibre has successfully handed off the request. The remaining limitation belongs to the website or account, not the viewer.

4. Rule Out Book, Viewer, and Plugin-Specific Causes

The calibre library database, conversion system, connected reader, email settings, and Content server are not normally involved when a word lookup fails in the desktop viewer. Investigate them only if your testing shows a direct connection.

4.1 Compare Library and Standalone Viewing

Save a copy of the test EPUB outside the calibre library and open it directly with the standalone E-book viewer. On Linux, the viewer can also be started with the ebook-viewer command.

If lookup fails only when the book is launched from one library record, close the viewer, confirm that the intended format is attached to that record, and reopen it. A book record may contain several formats, and you may have tested a PDF in one case and an EPUB in another.

If the same file behaves identically inside and outside the library, rebuilding the library will not help. Leave the library untouched.

4.2 Check Source File Quality Before Conversion

Conversion can sometimes produce cleaner, selectable text from a poorly structured source, but it should not be the first response. A conversion will not create accurate words from an image-only scan, repair a provider’s website, or restore blocked network access.

Consider converting a copy to EPUB only when all of these are true:

• The source contains real text.
• The text copies incorrectly or is divided into unusable fragments.
• A known-good EPUB works in the same viewer.
• You are legally permitted to convert the file and it is not restricted by copy protection.

Keep the original format. After conversion, test selection and lookup in the new EPUB before changing detailed conversion options. Success means ordinary words can be selected cleanly and looked up. If not, further conversion tuning is unlikely to solve a network or provider failure.

4.3 Disable Relevant Customizations Temporarily

A general metadata, device, news, or email plugin is unlikely to control viewer lookup. However, a viewer-related customization, custom source, system integration tool, or security extension may affect the result.

Record your current settings, then disable only the customization directly connected to viewing or opening URLs. Restart calibre and repeat the plain English EPUB test. If lookup begins working, restore items one at a time until the conflict returns.

A normal e-book device connected by USB should not affect lookup in the desktop viewer. USB mode and reader-device dictionaries matter only when the failure occurs on the physical device rather than inside calibre.

5. Use Debugging and a Temporary Clean Configuration

If the basic tests do not identify the cause, collect a reproducible result before reinstalling. Reinstallation often leaves calibre’s existing configuration in place, so it may not change a damaged preference or custom source.

5.1 Run the Viewer in Debug Mode

calibre provides a debug command that can start the E-book viewer separately. Close the normal viewer, open Terminal or Command Prompt, and run the following command with the path to a safe test EPUB:

calibre-debug -w -- "path/to/test-book.epub"

Paths containing spaces should remain in quotation marks. Reproduce the failure and inspect the terminal output for network, certificate, URL, or viewer errors. Do not post logs publicly without checking them for usernames, local paths, proxy credentials, or other private information.

A debug log is most useful when it records one simple action: open a known-good EPUB, select one word, and invoke one lookup source.

5.2 Test a Temporary Clean Configuration

For an advanced but non-destructive test, start calibre with a temporary configuration directory by setting CALIBRE_CONFIG_DIRECTORY to an empty folder before launching it. This creates a clean configuration test without deleting the normal library or preferences.

Use a new empty folder that can be removed afterward. Open the standalone viewer with the same known-good EPUB and test a built-in source before adding custom sources or plugins.

• If lookup works with the clean configuration, the normal configuration contains a conflicting preference, source, or customization.
• If lookup still fails, concentrate on the network, operating system, browser handoff, or calibre installation.
• If only the original book fails, return to its text quality and language metadata.

Do not point the temporary test at your only library and do not delete your normal configuration. The purpose is comparison, not migration.

5.3 Reinstall Only After the Clean Test

Reinstall calibre only when lookup fails with a known-good EPUB, a built-in provider, a clean temporary configuration, and a working unrestricted network. Download the installer from calibre’s official website and close running calibre processes before installing.

Afterward, repeat the same small test before restoring custom sources or changing settings. If it works, stop. If it does not, retain the debug output and the exact steps needed to reproduce the problem.

6. Quick Fix Checklist

1. Double-click or long-press a simple word and confirm that only the word is selected.
2. Copy the selection to verify that the book contains real, readable text.
3. Press Ctrl+L to open the lookup panel directly.
4. Test at least two built-in lookup sources.
5. Open a known-good plain English EPUB and look up a common word.
6. Check the book’s Languages field in Edit metadata.
7. Review custom source URLs for the exact {word} placeholder.
8. Test the provider’s website in a normal browser.
9. Check the proxies reported under Preferences and Miscellaneous.
10. Compare another trusted network without permanently disabling security tools.
11. Verify the operating system’s default browser if URL handoff does nothing.
12. Run the viewer with calibre-debug -w if the failure remains unclear.
13. Use a temporary clean configuration before reinstalling or resetting anything.

7. Frequently Asked Questions

7.1 Why Does calibre Select Text but Show No Definition?

The provider may be unavailable, blocked by the network, restricted to a different language, or unable to define the selected term. Test a simple word with another built-in source. If another source works, calibre’s viewer is functioning and you should stop changing global settings.

7.2 Why Does Dictionary Lookup Work in One Book but Not Another?

The failing book may have incorrect language metadata, image-only pages, malformed text, unusual character encoding, or words split across HTML elements. Compare copy-and-paste behavior and test the same word in a plain EPUB. This is usually a book-specific issue rather than a damaged calibre library.

7.3 Does Changing the Book Language Affect Lookup?

It can. calibre permits lookup sources to be restricted by book language. Correcting the Languages field and reopening the book can make the appropriate source available. Multilingual EPUBs may also contain internal language attributes that apply to individual passages.

7.4 Will Reinstalling calibre Reset Lookup Sources?

Not necessarily. Application configuration can remain after reinstalling, which is why a temporary clean configuration is a better diagnostic test. Do not delete your library or normal configuration merely to troubleshoot viewer lookup.

7.5 Is the Content Server Viewer the Same as the Desktop E-book Viewer?

No. The Content server reader runs in a web browser and depends on that browser’s capabilities and restrictions. If lookup fails only there, update or compare the browser and test the same book in calibre’s desktop viewer. Desktop viewer settings and browser-based viewer behavior should be diagnosed separately.

7.6 Can calibre Add Dictionary Lookup to My E-reader?

The desktop viewer’s lookup sources do not automatically become dictionaries on a connected Kindle, Kobo, or other device. Physical readers use their own firmware, dictionary packages, language rules, and retailer restrictions. If lookup works in calibre but fails on the device, consult the device’s supported dictionary and language settings rather than changing the calibre viewer.