{"id":14070600,"url":"https://github.com/hadynz/obsidian-kindle-plugin","last_synced_at":"2025-05-16T07:06:57.167Z","repository":{"id":38015058,"uuid":"351951207","full_name":"hadynz/obsidian-kindle-plugin","owner":"hadynz","description":"Sync your Kindle notes and highlights directly into your Obsidian vault","archived":false,"fork":false,"pushed_at":"2024-07-10T19:28:24.000Z","size":1202,"stargazers_count":1048,"open_issues_count":78,"forks_count":65,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-08T17:17:46.328Z","etag":null,"topics":["kindle-clippings","kindle-highlights","obsidian","obsidian-md","obsidian-plugin"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/hadynz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["hadynz"],"custom":["https://buymeacoffee.com/hadynz"]}},"created_at":"2021-03-27T01:06:47.000Z","updated_at":"2025-04-02T09:23:58.000Z","dependencies_parsed_at":"2024-08-13T07:17:55.185Z","dependency_job_id":"c07a59a4-2df9-4eb7-9fe7-14a9ac94f752","html_url":"https://github.com/hadynz/obsidian-kindle-plugin","commit_stats":{"total_commits":248,"total_committers":8,"mean_commits":31.0,"dds":"0.040322580645161255","last_synced_commit":"99cab6ec7f34c1cf98fed50232773cdac265a698"},"previous_names":[],"tags_count":66,"template":false,"template_full_name":"obsidianmd/obsidian-sample-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadynz%2Fobsidian-kindle-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadynz%2Fobsidian-kindle-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadynz%2Fobsidian-kindle-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadynz%2Fobsidian-kindle-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hadynz","download_url":"https://codeload.github.com/hadynz/obsidian-kindle-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485064,"owners_count":22078767,"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":["kindle-clippings","kindle-highlights","obsidian","obsidian-md","obsidian-plugin"],"created_at":"2024-08-13T07:07:55.083Z","updated_at":"2025-05-16T07:06:52.157Z","avatar_url":"https://github.com/hadynz.png","language":"TypeScript","funding_links":["https://github.com/sponsors/hadynz","https://buymeacoffee.com/hadynz","https://www.buymeacoffee.com/hadynz"],"categories":["TypeScript"],"sub_categories":[],"readme":"# Obsidian Kindle Plugin\n\n![CI/CD status](https://github.com/hadynz/obsidian-kindle-plugin/actions/workflows/main.yml/badge.svg)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/hadynz/obsidian-kindle-plugin)\n\nSync (and resync) your Kindle notes and highlights directly into your [Obsidian][1] vault. You\ncan choose to sync using one of two methods:\n\n### Amazon's Kindle Reader\n\nSync from the cloud any ebooks that you've purchased directly from Amazon. The plugin will\nscreen scrape your highlights from [Amazon's Kindle Reader][4] and continuously keep them in sync.\n\nThis method will not work for highlights from books, articles, PDFs, and personal documents\nnot purchased from Amazon (see next method).\n\n### Kindle Device (My Clippings)\n\nSync your highlights by uploading your `My Clippings.txt` file stored on your Kindle device.\nThis file includes highlights, bookmarks and notes for any book on your Kindle regardless\nif it has been purchased via Amazon.\n\nYou can extract your `My Clippings.txt` file by plugging it into your computer using USB.\n\n![](https://user-images.githubusercontent.com/315585/117566330-39a78000-b10a-11eb-834f-52b90ccda1ac.gif)\n\n## Features\n\n- **Continuous, automatic syncing** — One button press to sync your highlights using your Amazon account via [Amazon's Kindle Reader][4].\n\n  Subsequent syncing will do an intelligent diff and bring in any new highlights without impacting any edits that you've done to your highlights file.\n\n- **Sync non-Amazon books** — Sync your highlights by uploading your `My Clippings.txt` file from your Kindle device\n\n- **Enriched metadata** — Enrich your notes by downloading extra metadata information about your book from Amazon.com\n\n- **Powerful, flexible templating with preview** — Customise your highlights and file names to your liking by configuring your own template using ([Nunjucks][2]) templating language with live preview\n\n## Mission statement\n\nInspired by Obsidian's principle of \"your data sitting in a local folder\" and \"never leaving\nyou're life's work held hostage in the cloud again\", this plugin tries to do exactly that\nwith your precious Kindle notes and highlights. Why should you struggle in accessing your own\ndata, or paying for a third party service to access information that you own?\n\n## Known considerations\n\n### Security\n\nIf you choose to sync your highlights via Amazon's online Kindle Reader, it is important to note\nthat by logging in to your Amazon account via Obsidian your Amazon session becomes available to\nany other plugin across your vaults until your session expires.\n\nYou can mitigate this risk by logging out after every sync (from settings) or using the offline\nmethod of syncing by uploading your `My Clippings.txt` file instead.\n\n### Export limits\n\nFor several reasons (see [here][5] and [here][6]) the Kindle platform can sometimes limit the amount\nof highlighted text that can be exported from a particular book. This limit varies from book to book, purchased from Amazon or have DRM protection. There is currently no known alternative to work around this.\n\n## Say Thanks\n\nIf you like this plugin and would like to buy me a coffee, you can!\n\n[\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-violet.png\" alt=\"BuyMeACoffee\" width=\"140\"\u003e](https://www.buymeacoffee.com/hadynz)\n\n[![GitHub Sponsors](https://img.shields.io/github/sponsors/hadynz?style=social)](https://github.com/sponsors/hadynz)\n\n## License\n\n[MIT](LICENSE)\n\n[1]: https://obsidian.md\n[2]: https://mozilla.github.io/nunjucks\n[3]: https://github.com/pjeby/hot-reload\n[4]: https://read.amazon.com/notebook\n[5]: https://help.readwise.io/article/47-why-are-my-kindle-highlights-truncated-ellipses#:~:text=Publishers%20require%20Amazon%20to%20place,the%20book%20will%20be%20truncated.\n[6]: https://brian.carnell.com/articles/2018/route-around-amazon-kindles-ridiculous-limits-on-highlights-exporting-with-bookcision/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadynz%2Fobsidian-kindle-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhadynz%2Fobsidian-kindle-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadynz%2Fobsidian-kindle-plugin/lists"}