Skip to content

📎 Python module to manipulate Kindle clippings files.

License

Notifications You must be signed in to change notification settings

samueldg/clippings

Repository files navigation

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.

About

📎 Python module to manipulate Kindle clippings files.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages