Code Monkey home page Code Monkey logo

obsidian-kindle-plugin's Introduction

Obsidian Kindle Plugin

CI/CD status GitHub release (latest by date)

Sync (and resync) your Kindle notes and highlights directly into your Obsidian vault. You can choose to sync using one of two methods:

Amazon's Kindle Reader

Sync from the cloud any ebooks that you've purchased directly from Amazon. The plugin will screen scrape your highlights from Amazon's Kindle Reader and continuously keep them in sync.

This method will not work for highlights from books, articles, PDFs, and personal documents not purchased from Amazon (see next method).

Kindle Device (My Clippings)

Sync your highlights by uploading your My Clippings.txt file stored on your Kindle device. This file includes highlights, bookmarks and notes for any book on your Kindle regardless if it has been purchased via Amazon.

You can extract your My Clippings.txt file by plugging it into your computer using USB.

Features

  • Continuous, automatic syncing — One button press to sync your highlights using your Amazon account via Amazon's Kindle Reader.

    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.

  • Sync non-Amazon books — Sync your highlights by uploading your My Clippings.txt file from your Kindle device

  • Enriched metadata — Enrich your notes by downloading extra metadata information about your book from Amazon.com

  • Powerful, flexible templating with preview — Customise your highlights and file names to your liking by configuring your own template using (Nunjucks) templating language with live preview

Mission statement

Inspired by Obsidian's principle of "your data sitting in a local folder" and "never leaving you're life's work held hostage in the cloud again", this plugin tries to do exactly that with your precious Kindle notes and highlights. Why should you struggle in accessing your own data, or paying for a third party service to access information that you own?

Known considerations

Security

If you choose to sync your highlights via Amazon's online Kindle Reader, it is important to note that by logging in to your Amazon account via Obsidian your Amazon session becomes available to any other plugin across your vaults until your session expires.

You can mitigate this risk by logging out after every sync (from settings) or using the offline method of syncing by uploading your My Clippings.txt file instead.

Export limits

For several reasons (see here and here) the Kindle platform can sometimes limit the amount of 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.

Say Thanks

If you like this plugin and would like to buy me a coffee, you can!

BuyMeACoffee

GitHub Sponsors

License

MIT

obsidian-kindle-plugin's People

Contributors

francescotonini avatar gozes avatar hadynz avatar jmmeessen avatar kfcampbell avatar miharekar avatar owenvachell avatar philipesteiff avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.