skip to navigation
skip to content

whoarder 0.3.0

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 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).

As module:

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.

Similar Software

License and contact

Licensed under the BSD-new license, 2013 (see LICENSE.txt), / @ronjouch

File Type Py Version Uploaded on Size
whoarder-0.3.0.tar.gz (md5) Source 2014-07-04 44KB