Package: kindle2notion
A program to copy all your Kindle highlights and notes to a page in Notion.Explore the docs·File issues and feature requests hereIf you found this script helpful or appreciate my work, you can support me here:Table of ContentsTable of ContentsAbout The ProjectGetting StartedPrerequisitesInstallation & SetupUsageRoadmapContributingLicenseContactAbout The ProjectA Python package to export all the clippings from your Kindle device to a page in Notion. Run this script whenever you plug in your Kindle device to your PC.A key inspiration behind this project was the notes saving feature on Google Play Books, which automatically syncs all your highlights from a book hosted on the service to a Google Doc in real time. I wanted a similar feature for my Kindle and this project is one step towards a solution for this problem.Intended forAvid readers who would want to browse through their prior reads and highlights anytime anywhere.For those who like to take notes alongside their highlights.Getting StartedNOTENeed a step-by-step guide to setting this package up? Clickherefor the full guide.To get a local copy up and running follow these simple steps:PrerequisitesA Kindle device.A Notion account to store your links.Python 3 on your system to run the code.Installation & SetupNOTEAs of 10-08-2022, the latest update to this package relies on the offical Notion API for sending API requests. This requires you to create an integration token fromhere. For old users, you'd have to switch to this method as well sincenotion-pyisn't being maintained anymore.Install the library.pipinstallkindle2notionCreate an integration on Notion.Duplicate thisdatabase templateto your the workspace you want to use for storing your Kindle clippings.OpenSettings & Membersfrom the left navigation bar.Select theIntegrationsoption listed underWorkspacesin the settings modal.Click onDevelop your own integrationsto redirect to the integrations page.On the integrations page, select theNew integrationoption and enter the name of the integration and the workspace you want to use it with. Hit submit and your internal integration token will be generated.Go back to your database page and click on theSharebutton on the top right corner. Use the selector to find your integration by its name and then clickInvite. Your integration now has the requested permissions on the new database.UsagePlug in your Kindle device to your PC.You need the following three arguments in hand before running the code:Takeyour_notion_auth_tokenfrom the secret key bearer token provided atFindyour_notion_database_idfrom the URL of the database you have copied to your workspace. For reference,https://www.notion.so/myworkspace/a8aec43384f447ed84390e8e42c2e089?v=...
                                  |--------- Database ID --------|your_kindle_clippings_fileis the path to yourMy Clippings File.txton your Kindle.Additionally, you may modify some default parameters of the command-line with the following options of the CLI:--enable_highlight_dateSet to False if you don't want to see the "Date Added" information in Notion.--enable_book_coverSet to False if you don't want to store the book cover in Notion.Export your Kindle highlights and notes to Notion!On MacOS and UNIX,kindle2notion'your_notion_auth_token''your_notion_table_id''your_kindle_clippings_file'On Windowspython-mkindle2notion'your_notion_auth_token''your_notion_table_id''your_kindle_clippings_file'You may also avail help with the following command:kindle2notion--help
python-mkindle2notion--helpNOTEThis code has been tested on a 4th Gen Kindle Paperwhite on both MacOS and Windows.RoadmapSee theopen issuesfor a list of proposed features (and known issues).ContributingAny contributions you make aregreatly appreciated.Fork the ProjectCreate your Feature Branch (git checkout -b feature/AmazingFeature)Commit your Changes (git commit -m 'Add some AmazingFeature')Push to the Branch (git push origin feature/AmazingFeature)Open a Pull RequestLicenseDistributed under the MIT License. SeeLICENSEfor more information.ContactJeffrey Jacob (Twitter|Email|LinkedIn)