whoarder converts your Kindle's 'My Clippings.txt' file to a more pleasant, sortable, filterable HTML file
whoarder converts your Kindle’s My Clippings.txt file to a more pleasant, sortable, filterable HTML file:
Installation & Requirements
To install, just pip install whoarder . Requirements are:
- Python 3.3 (so far I only tested with 3.3 on Linux, tests and patches to increase compatibility very welcome)
- The jinja2 and chardet2 modules (automatically handled as setup.py dependencies)
- Only tested on a My Clippings.txt file produced by a Kindle Paperwhite (ok/ko reports for other devices and test data welcome through GitHub).
- Kindle Fire & Kindle Fire HD are not supported, since they do note create the My Clippings.txt file. If you know where to dig that data for those versions, patches welcome.
Run whoarder /path/to/My Clippings.txt [destination] . If destination is omitted, the output HTML will be written in the same place (overwriting any pre-existing HTML).
from clippings import Clippings clippings = Clippings(args.source, args.destination) # contains a 'clippings' dict containing the information clippings.export_to_html() # exports as HTML
Test data and unittest-based unit tests are in the tests folder.