{"id":13732338,"url":"https://github.com/msuozzo/Lector","last_synced_at":"2025-05-08T06:31:57.330Z","repository":{"id":36463598,"uuid":"40768813","full_name":"msuozzo/Lector","owner":"msuozzo","description":"An API for your Kindle data","archived":false,"fork":false,"pushed_at":"2023-09-01T20:41:45.000Z","size":23,"stargazers_count":296,"open_issues_count":3,"forks_count":37,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-04-26T14:21:50.328Z","etag":null,"topics":["amazon","kindle","kindle-data","phantomjs"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msuozzo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-08-15T15:49:18.000Z","updated_at":"2024-03-19T13:33:37.000Z","dependencies_parsed_at":"2024-01-07T21:02:43.664Z","dependency_job_id":"400d0f2c-695b-43c4-b3bb-c3500d282fcd","html_url":"https://github.com/msuozzo/Lector","commit_stats":{"total_commits":17,"total_committers":2,"mean_commits":8.5,"dds":0.4117647058823529,"last_synced_commit":"1570f7734a1c68f294648f44088a7ccb09c26241"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msuozzo%2FLector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msuozzo%2FLector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msuozzo%2FLector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msuozzo%2FLector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msuozzo","download_url":"https://codeload.github.com/msuozzo/Lector/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252961836,"owners_count":21832196,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon","kindle","kindle-data","phantomjs"],"created_at":"2024-08-03T02:01:53.634Z","updated_at":"2025-05-08T06:31:52.320Z","avatar_url":"https://github.com/msuozzo.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Lector\nAn API for your Kindle data.\n\nPython bindings are provided but any language that can run the JavaScript\nfound in `api.py` from within a Kindle Cloud Reader session may easily access\nthis data.\n\n### Dependencies\n**PhantomJS**:\n\n* macOS (Homebrew)\n    * ```brew install --cask phantomjs```\n* Ubuntu (at least 14.04)\n    * Guide provided and maintained by @julionc\n      [here](https://gist.github.com/julionc/7476620)\n\n### Usage\n```python\nimport lector\n\napi = lector.KindleCloudReaderAPI('my_amazon_username', 'my_amazon_password')\nmy_library = api.get_library_metadata()\nbook = my_library[0]\nbook_progress = api.get_book_progress(book.asin)\n_, current_page, last_page = book_progress.page_nums\n\nprint 'Currently reading %s (Page %d of %d)' % (book.title, current_page, last_page)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsuozzo%2FLector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsuozzo%2FLector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsuozzo%2FLector/lists"}