Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Convert Kindle clippings / highlights / notes
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
README.markdown
kindle_clippings.rb

README.markdown

Introduction

This is a simple ruby script to convert kindle clippings / notes / highlights to plain text (or viki markup).

For now, only Kindle version 2 (e.g. Kindle DX) clipping files are supported (i.e. tested). I have no idea if the script works for other versions.

Example usage:

kindle_clippings.rb --dir ~/MyClips /media/kindle/My\\ Clippings.txt

Installation

Copy or symlink kindle_clippings.rb to a directory in $PATH.

Configuration

The script can be configured via YAML files that is searched in:

  • /etc/kindle_clippings.yml
  • $HOME/.kindle_clippings.yml
  • $HOME/.kindle_clippings_$HOSTNAME.yml
  • Windows: %USERPROFILE%/kindle_clippings.yml

Example configuration file:

--- 
format: viki
outdir: /home/tom/Wiki/KindleNotes
myclippings: /home/tom/sync/Kindle/My Clippings.txt

An initial configuration file can be created with the following command:

kindle_clippings.rb --print-config > ~/.kindle_clippings.yml

Requirements

  • Ruby 1.8
Something went wrong with that request. Please try again.