Installation & Requirements

To install, just pip install whoarder (link to PyPI page). Requirements are:

• Python ≥3.3 (so far I only tested with 3.3 and 3.4 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

• Web services

  • Clippings Converter

  • Clipper

• Offline

  • (PHP) kindle-split-by-book

License and contact

Licensed under the MIT license, 2013-2016 (see LICENSE), ronan@jouchet.fr / @ronjouch