Skip to content

Do something useful with your Kindle notes :) This script extracts individual words from My Clippings file hidden on your Kindle e-reader, translates them using Google Translate and exports the pair "original word" → "translation" into a .txt file from which you can learn these words or import them into an application such as Quizlet.

License

Notifications You must be signed in to change notification settings

vardecab/kindle-words

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

kindle-words

Do something useful with your Kindle notes :) This script extracts individual words from My Clippings file hidden on your Kindle e-reader, translates them using Google Translate and exports the pair "original word" → "translation" into a .txt file from which you can learn these words or import them into an application such as Quizlet.

Screenshots

How to use

Windows

  1. Connect your Kindle via USB cable to your computer.
  2. Download script.exe from Releases.
  3. Run it.
  4. Write source & target languages or wait if defaults (en & pl) are ok.
  5. Write drive letter associated with Kindle or wait if default (D) is ok.
  6. Wait a few minutes - words are being translated.
  7. Go to output/kindle-words_export.txt to check exported file.
  8. (optional) Add it to Quizlet.
  9. Voilà ✨

Roadmap

  • 🎯 Dictionary definitions. (Need a different API)
  • Improve regex formula to better deal with words that have special characters.
  • Extract single words from source file.
  • Output list line by line.
  • Use API to translate words.
  • Skip the same words on subsequent imports.
  • Use DeepL rather than Google Translate. (Requires paid subscription)

Release History

  • 1.1.1: Fixed io.open bug; added some try/except to catch more errors; re-enabled timeout_time; added last_word export so it's easy to see which words are new and which are old. Published in Releases.
  • 1.1: Quite a big re-write: it now works properly with My Clippings.txt file from Kindle - all bugs are fixed. Initial run takes ~ 10 minutes to complete (depending on the size of your file) but afterwards it's usually < 1 minute because data from previous run is stored locally for comparison - only new words are being translated to save time and improve speed.
  • 1.0.0: Using new API - deep-translator.
  • 0.12.5: Bug in the API discovered.
  • 0.12.4: Cleared up the code for better readability.
  • 0.12.3: Fixes to regex formula so it also takes words with , & .
  • 0.12.2: Print which folder was created for exported files.
  • 0.12.1: Renamed variables & export files' names to improve readability.
  • 0.12: Be able to select source & target languages.
  • 0.11: Added input timeout.
  • 0.10: Take input file directly from Kindle once drive letter is given.
  • 0.9: Export files to specific folders based on today's date & ID.
  • 0.8: Add script runtime info.
  • 0.7: Fixes to regex formula so it also takes words with ., - & ".
  • 0.6: Print translations directly to kindle-words_export-{DATE}.txt.
  • 0.5: No more duplicate words.
  • 0.4: Fixed charmap' codec can't encode character (...) problem that occured with PL characters.
  • 0.3: Translation with googletrans lib.
  • 0.2: Output list line by line + export to a .txt. file.
  • 0.1: Initial release. Extract single words from source file using regex.

Versioning

Using SemVer.

License

GNU General Public License v3.0, see LICENSE.md.

Acknowledgements

Packages

Articles

Tools

About

Do something useful with your Kindle notes :) This script extracts individual words from My Clippings file hidden on your Kindle e-reader, translates them using Google Translate and exports the pair "original word" → "translation" into a .txt file from which you can learn these words or import them into an application such as Quizlet.

Topics

Resources

License

Stars

Watchers

Forks

Languages