Amazon Kindle clippings parser


Keywords
amazon, kindle, clipping, e-book
License
MIT
Install
pip install clippings==0.9.0

Documentation

Clippings

Python module to manipulate Amazon Kindle clippings files.

It allows you to:

  • Parse your existing clippings file into a structured representation;
  • Generate clippings file programmatically.

Latest version released on PyPI Build status

Installation

pip install clippings

Usage

Command-line Usage

# Parse a clippings file
clippings -o json ./clippings.txt

# or from stdin:
cat clippings.txt | clippings -

Programmatic Usage

from clippings import parse_clippings

my_clippings_file = ...
parse_clippings(my_clippings_file)

Want to parse non-English clippings?

Here's a highlight clipping taken from a Kindle that speaks Spanish::

El Principe de la Niebla (Carlos Ruiz Zaf贸n)
- La subrayado en la p谩gina 4 | posici贸n 60-60 | A帽adido el mi茅rcoles, 6 de julio de 2022 06:54:57

asintiendo a una pregunta que Max no hab铆a llegado a formular.

parse_clippings won't parse this by default but you can write your own parser for the second line and pass it to the parameter metadata_parser.

You can take a look at an example here.