An API for your Kindle data
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lector Bump version May 20, 2017
.gitignore Added proper package structure and setup script Nov 11, 2015
CHANGES.md Bump version May 20, 2017
LICENSE Initial commit Aug 15, 2015
MANIFEST.in Added missing files to manifest Nov 11, 2015
README.md Add usage example Oct 8, 2016
requirements.txt Rebranded to Lector, bumped selenium version Nov 11, 2015
setup.py Mostly cosmetic changes Dec 24, 2015

README.md

Lector

An API for your Kindle data.

Python bindings are provided but any language that can run the javascript found in api.py from within a Kindle Cloud Reader session may easily access this data.

Dependecies

PhantomJS:

  • OS X (Homebrew)
    • brew install phantomjs
  • Ubuntu (at least 14.04)
    • Guide provided and maintained by @julionc here

Usage

import lector

api = lector.KindleCloudReaderAPI('my_amazon_username', 'my_amazon_password')
my_library = api.get_library_metadata()
book = my_library[0]
book_progress = api.get_book_progress(book.asin)
_, current_page, last_page = book_progress.page_nums

print 'Currently reading %s (Page %d of %d)' % (book.title, current_page, last_page)