OhiyoX/WordDumb

A calibre plugin that generates Word Wise and X-Ray files then sends them to Kindle. Supports KFX, AZW3 and MOBI eBooks. X-Ray supports 18 languages.

WordDumb

A calibre plugin that generates Word Wise and X-Ray files then sends them to Kindle. Supports KFX, AZW3 and MOBI eBooks.

Languages X-Ray supports: Català, Dansk, Deutsch, English, Español, Français, Italiano, Lietuvių, Nederlands, Norsk bokmål, Polski, Português, Română, Ελληνικά, Македонски, Русский, 中文, 日本語.

X-Ray doesn't support macOS, because macOS prohibits calibre from loading unsigned library.

Contribute

Please read CONTRIBUTING.

How to use

• Install calibre

  • Arch Linux

  # pacman -Syu --needed calibre
  

  • Other Linux distros

  $ sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
  

  • macOS: use Homebrew or download from https://calibre-ebook.com/download_osx

  $ brew install calibre
  

  • Windows: use Chocolatey or download from https://calibre-ebook.com/download_windows64

  $ choco install calibre
  

• Install Python(pip)

  • Arch Linux

    pip module is included in python.

  • Ubuntu

  $ sudo apt install python3-pip
  

  • macOS

  // recommended
  $ brew install python
  
  // or install outdated pip from Apple Command Line Tools
  $ xcode-select --install
  

  • Windows: use Chocolatey or download from https://www.python.org/downloads

  $ choco install python
  

• Install WordDumb:

install.mov

• Install KFX Input plugin for KFX books(optional).

• Set preferences

  • Enable "search people" option for nonfiction books and novels that have character pages on Wikipedia to add people descriptions in X-Ray.

  • Larger spaCy model has higher NER precision, more details at https://spacy.io/models/en

preferences.mov

• Connect Kindle to calibre, select one book or multiple books then click the plugin icon or menu.

usage.mov

• Never add ASIN to your book, that will cause Kindle to replace Word Wise and X-Ray files.

• Don't add soft hyphens, it will cause the plugin to produce a mediocre X-Ray file.

• This plugin requires access to https://files.pythonhosted.org (download dependencies) and https://raw.githubusercontent.com (download NLTK and spaCy model) at first run, and https://wikipedia.org every time if X-Ray is enabled. These domains might be blocked in some countries(Censorship of Wikipedia, Censorship of GitHub).

I need about tree-fiddy

License

This work is licensed under GPL version 3 or later.

Icon made by Freepik from www.flaticon.com.