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