clippings.py

A Python script to extract book highlights from a Kindle MyClippings.txt file into a structured file.

• Installation
• Running
• Environment and dependencies setup
• Related work

Installation

Requires Python 3.

Install dependencies with pip or easy_install:

pip install -r requirements.txt

Running

Extract highlights from MyClippings.txt file to .csv spreadsheet:

$ ./clippings.py extract MyClippings.txt

Full usage:

$ ./clippings/clippings.py --help
MyClippings.txt management tool.

Usage:
  clippings.py extract INFILE [-o FILE] [--no-title]
  clippings.py (-h | --help)
  clippings.py --version

Options:
  -o FILE       Specify output file [default ./clippings.csv]
  -h --help     Show this screen
  --no-title    Omit title row in output.
  --version     Show version

Environment and dependencies setup

Create new virtual env:

python3 -m venv .venv

Activate virtual env:

source .venv/bin/activate

Install requirements:

pip install -r requirements.txt

Related work

kindle-clippings is a Python script that processes your My Clippings.txt file and outputs clippings as RST files.