/apple-notes-readwise

Export Readwise highlights to Apple Notes

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

Readwise ๐Ÿ“š to Apple Notes Export ๐Ÿ“ฅ

Warning

โš ๏ธ Please note that this product is currently in early development, and you may encounter some issues during use or while syncing.

We are actively working towards a stable release and greatly appreciate your feedback. We welcome early beta testers to help us improve the app.

If you experience any problems, please feel free to submit an issue. Pull requests are also welcome!

Your contributions are invaluable as we work towards delivering a more reliable experience. Thank you for your support! โš ๏ธ

This app enables you to easily export all your digital highlights to Apple Notes from a variety of sources such as Amazon Kindle, Apple Books, Google Play Books, Instapaper, Pocket, Medium, Twitter, PDFs, and more.

Note

This app requires a subscription with Readwise - a paid service that makes it easy to aggregate and review all your reading data into one place.

Features

  • Customize Formatting ๐Ÿ’…: - use Readwise's formatting tool to change how the note appears in Apple Notes.
  • Multi-Account Support ๐Ÿ‘ฅ: Select from multiple Apple Notes accounts (e.g. iCloud, Gmail).
  • Folder Management ๐Ÿ“: Automatically create and verify folders in Apple Notes.
  • Automatic Syncing ๐Ÿ”„: Configure the frequency of when new highlights are added.

Installation

  1. Download the latest release from the Release section.
  2. Extract the download file and drag it to your Applications folder. From there, run the app executable.

Usage

  1. Launch the App: Start the application after installation.
  2. Select Account: Choose your Apple Notes account from the dropdown menu (e.g., iCloud, Gmail).
  3. Specify Folder:
    • Enter the name of the folder where notes will be imported.
    • If the folder doesnโ€™t exist, it will be created.
  4. Pick a sync frequency:
    • Use the select box to pick a frequency your want your highlights to re-sync. (e.g. Every 1 Hour, Every 12 Hours etc.)
  5. Initiate Sync: Click the button to start the sync process. You'll get messages on the progress of the current sync.
  6. Success Notification: Once completed, youโ€™ll receive a success message.

Screenshots

main-screen

Track sync progress

sync-highlights-progress

Update sync frequency

update-sync-frequency

Select account

select-account

Demo

demo

Development Setup

  1. Clone the repository:

    git clone https://github.com/Scarvy/apple-notes-readwise.git
    cd <repo>
  2. Install dependencies:

    npm install
  3. Run the app in development mode:

    npm start
  4. Build the app for production:

    npm run make

Technical Details

Built With


Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch:
    git checkout -b feature-name
  3. Commit your changes:
    git commit -m "Add feature"
  4. Push to the branch:
    git push origin feature-name
  5. Submit a pull request.

Known Limitations

  • Only supports macOS due to reliance on AppleScript.
  • Requires the Apple Notes app to be installed and configured.

License

This project is licensed under the GNU GENERAL.


Contact

For any issues or feature requests, please open an issue on the GitHub Issues page.