Skip to main content

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.

Metadata

Release files for clippings 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clippings 0.9.0
File Size Uploaded Provenance
clippings-0.9.0.tar.gz 5.9 kB Without provenance Details

Release files / clippings-0.9.0.tar.gz

Download URL clippings-0.9.0.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
9c55649bc2ce72f6e4efb0dd350a1de4396e4909370d5b73f145a1adc4174bde
BLAKE2b-256 checksum
How to use checksums
5c1034ed529804ddae013123d2a37cc30e47abac86f9fb3c3ae0cdcddf784e2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.10.8

Security for clippings 0.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page