Skip to content

KFX Format Does Not Display Wordwise and X-Ray with WordDumb 3.3.2 and Calibre 8.3 on macOS 15.4.1 #307

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
3 tasks done
theBillLee opened this issue May 7, 2025 · 5 comments

Comments

@theBillLee
Copy link

Checkboxes

  • I have read the installation and usage documents.
  • I have not found similar open/closed issue or disscussion.
  • Reboot doesn't fix the problem.

Describe the bug and copy the error message

Description:
I am encountering an issue where WordDumb successfully generates Wordwise and X-ray in AZW3 format but fails to shpe them in KFX format on Kindle. Below are the details of my setup and the problem:

Environment:

  • OS: macOS 15.4.1 (MacBook Air M1)

  • Target Device: Kindle PaperWhite 12th Gen, Kindle OS 5.17.0.4

  • WordDumb Version: 3.3.2

  • Calibre Version: 8.3

  • Input File: DeDRM KFX Size 19.5 MB

  • Issue Details: When attempting to generate Wordwise and X-ray, the process completes successfully for AZW3 format and KFX, but fails for KFX format show in Kindle( azw3 is OK). I have ensured that the KFX input Plugin is installed and enabled in Calibre.

Steps Taken::

  1. Verified that Calibre's KFX Output Plugin is installed and enabled.
  2. Tested with a DRM-free input file to rule out DRM issues.
  3. Attempted manual conversion of AZW3 to KFX in Calibre, [mention result if applicable].

Expected Behavior: WordDumb should generate vocabulary prompts in both AZW3 and KFX formats without issues.
Actual Behavior: KFX format generation fails while AZW3 works as expected.

Could you please assist in identifying the cause of this issue or suggest a workaround for generating KFX files compatible with my Kindle PaperWhite (12th Gen, OS 5.17.0.4)? Thank you!

Plugin settings and reproduce steps

  1. Connect the Kindle device to Calibre on my Mac.
  2. Select the Kindle device in Calibre.
  3. Click on WordDumb to generate Wordwise and X-Ray for the selected book.
  4. After generation completes successfully, eject the Kindle from Calibre.
  5. Check the Kindle device; Wordwise and X-Ray are not effective for books in KFX format.
  6. Reconnect the Kindle to my Mac and inspect the file path under the .sdr folder; I can confirm the presence of generated files such as:
LanguageLayer.en.xxx.kll (for Wordwise)
XRAY.entities.xxx.asc (for X-Ray)
  1. Repeat the same steps with a book in AZW3 format; Wordwise and X-Ray display correctly on the Kindle.

Generated files, screenshots or videos

No response

@xxyzz
Copy link
Owner

xxyzz commented May 7, 2025

Maybe try delete both azw3 and kfx books from Kindle then try again?

I have tested a kfx book and word wise is enabled.

@theBillLee
Copy link
Author

I've tried that, but Word Wise still isn't working with the KFX format. It seems like the KFX and KLL files aren't linking up properly.

@theBillLee
Copy link
Author

Image

@xxyzz
Copy link
Owner

xxyzz commented May 8, 2025

Sorry, no idea what is wrong.

Is the last .sdr folder created by Kindle? Have you tried to move kll file to that folder and see if it works?

@theBillLee
Copy link
Author

the last .sdr folder is created by Calibre.
Tried it. It doesn't work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants