Kindle Highlights Versions Save

Fixes runtime dependency issue (PR https://github.com/speric/kindle-highlights/pull/17 by @c01o)

This release includes some breaking changes due to the new structure of Amazon's "Kindle Notes and Highlights" page. See https://github.com/speric/kindle-highlights/pull/16 for more details.

• Attempt auth-ing two times before failing (PR #12 by @sirupsen)
• Pick random user agent when auth-ing (PR #13 by @sirupsen)

• Raise error when Amazon credentials are invalid (@Sirupsen, PR #9)

See PR https://github.com/speric/kindle-highlights/pull/7

Last pre-1.0.0 release. Works on older Rubies.

Install

gem install kindle-highlights -v=0.0.8

Use

require 'kindle_highlights'

# Pass in the email address & password you use to sign into your Amazon Kindle account
kindle = KindleHighlights::Client.new("[email protected]", "password")

# Get a list of all your Kindle books
kindle.books
#=>
{
  "B002JCSCO8" => "The Art of the Commonplace: The Agrarian Essays of Wendell Berry",
  "B0049SPHC0" => "Calvinistic Concept of Culture, The",
  "B00E25KVLW" => "Ruby on Rails 4.0 Guide",
  "B004X5RLBY" => "The Seven Lamps of Architecture",
  "B0026772N8" => "Zen and the Art of Motorcycle Maintenance"
}

# Get your highlights for a specific book by passing in the ASIN
kindle.highlights_for("B005CQ2ZE6")
#=>
[
  {
    "asin"          => "B005CQ2ZE6",
    "customerId"    => "...",
    "embeddedId"    => "From_the_Garden_to_the_City:420E805A",
    "endLocation"   => 29591,
    "highlight"     => "One of the most dangerous things you can believe in this world is that technology is neutral.",
    "howLongAgo"    => "1 year ago",
    "startLocation" => 29496,
    "timestamp"     => 1320901233000
  }
]