skip to navigation
skip to content

Not Logged In

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

Usage

Command-line:

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

Tests:

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), ronan@jouchet.fr / @ronjouch

 
File Type Py Version Uploaded on Size
whoarder-0.3.0.tar.gz (md5) Source 2014-07-04 44KB
  • Downloads (All Versions):
  • 7 downloads in the last day
  • 71 downloads in the last week
  • 251 downloads in the last month