https://github.com/bandantonio/obsidian-apple-books-highlights-plugin

Import highlights and notes from your Apple Books to Obsidian
https://github.com/bandantonio/obsidian-apple-books-highlights-plugin

annotations apple-books apple-books-annotations apple-books-highlights apple-books-notes applebooks highlights ibooks ibooks-annotations ibooks-highlights importer mac macos obsidian obsidian-plugin plugin second-brain zettelkasten

Last synced: 7 months ago
JSON representation

Import highlights and notes from your Apple Books to Obsidian

• Host: GitHub
• URL: https://github.com/bandantonio/obsidian-apple-books-highlights-plugin
• Owner: bandantonio
• License: mit
• Created: 2024-01-04T18:34:33.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2024-08-10T23:51:21.000Z (over 1 year ago)
• Last Synced: 2025-04-01T01:01:41.827Z (8 months ago)
• Topics: annotations, apple-books, apple-books-annotations, apple-books-highlights, apple-books-notes, applebooks, highlights, ibooks, ibooks-annotations, ibooks-highlights, importer, mac, macos, obsidian, obsidian-plugin, plugin, second-brain, zettelkasten
• Language: TypeScript
• Homepage: https://obsidian.md/plugins?id=apple-books-import-highlights
• Size: 5.3 MB
• Stars: 70
• Watchers: 2
• Forks: 3
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# Obsidian Apple Books highlights import plugin

![Plugin preview](./docs/assets/plugin-preview.png)

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/bandantonio/obsidian-apple-books-highlights-plugin/release.yml?branch=master&style=for-the-badge&logo=github)

![GitHub manifest version](https://img.shields.io/github/manifest-json/v/bandantonio/obsidian-apple-books-highlights-plugin?style=for-the-badge&logo=obsidian&color=%230082FC)

![GitHub Downloads](https://img.shields.io/github/downloads/bandantonio/obsidian-apple-books-highlights-plugin/total?style=for-the-badge&logo=github&color=%237C3AED)

[![Coveralls](https://img.shields.io/coverallsCoverage/github/bandantonio/obsidian-apple-books-highlights-plugin?branch=master&style=for-the-badge&logo=coveralls&label=Test%20coverage&color=%233F5767)](https://coveralls.io/github/bandantonio/obsidian-apple-books-highlights-plugin?branch=master)

[![GitHub Discussions](https://img.shields.io/badge/github_discussions-blue?style=for-the-badge&color=%23373e47&logo=github)](https://github.com/bandantonio/obsidian-apple-books-highlights-plugin/discussions)

[![Plugin's page on Obsidian forum](https://img.shields.io/badge/obsidian_forum-blue?style=for-the-badge&color=%237C3AED&logo=obsidian)](https://forum.obsidian.md/t/new-plugin-apple-books-import-highlights/76856/21)

## Overview

This plugin aims to be a **fast**, **customizable**, **reliable**, and **up-to-date** solution to import your Apple Books highlights to Obsidian:

- ⚡️ **Fast**: It takes less than 1 second to import ~1000 highlights.

- 🎨 **Customizable**: Use Handlebars and Markdown to customize the output of your highlights the way you want. Check the [`Template variables`](https://mister-gold.pro/obsidian-apple-books-highlights-plugin/customization/templates-and-variables.html#template-variables) section in documentation for more information.

- 🦾 **Reliable**:

  - Import actual highlights with only the metadata you need. No visual noise with the deleted but still exported highlights, or, on the contrary, highlights and notes that make no sense without the context.

  - Back up your highlights before each import to avoid accidental data loss (optional, but recommended).

- 📚 **Dataview-ready**: The default template creates highlights in a format that is compatible with [Dataview](https://blacksmithgu.github.io/obsidian-dataview/), so you can use your highlights in Dataview queries to unleash possible use cases even further (for example, to create a list of books you've read).

- 🔄 **Up-to-date**: The plugin is updated regularly to support the latest versions of Obsidian, and Apple Books, as well as react to the users' feedback.

## What users say

- 💬 *Nice work. This is really quick*. - **cmyplay**

- 💬 *I just wanted to say that I love your plugin. It’s exactly what I need with no frills*. - **civilserf**

- 💬 *I am very grateful for the plugin you developed, which has made organizing my reading notes much more convenient*. - **JeffreyGH10**

- 💬 *Love this! great work!* - **dschense**

- 💬 *Thanks for sharing this nice plugin*. - **modatwork**

- 💬 *Your plugin is super fast and useful!* - **weslau**

## Try it out

[![Plugin's page on Obsidian forum](https://img.shields.io/badge/install_plugin-blue?style=for-the-badge&color=%237C3AED&logo=obsidian)](https://obsidian.md/plugins?id=apple-books-import-highlights)

## Documentation

- [Get Started][get-started]

- [Settings][settings]

- [Templates and variables][templates-and-variables]

[get-started]: https://mister-gold.pro/obsidian-apple-books-highlights-plugin/guide/get-started.html

[settings]: https://mister-gold.pro/obsidian-apple-books-highlights-plugin/guide/settings.html

[templates-and-variables]: https://mister-gold.pro/obsidian-apple-books-highlights-plugin/customization/templates-and-variables.html

## Contributing

Ready to contribute? Check the [Contributing guidelines](CONTRIBUTING.md) to get started.

Your feedback and ideas are more than welcome and highly appreciated! Join the discussion in:

- [Obsidian Forum](https://forum.obsidian.md/t/new-plugin-apple-books-import-highlights/76856)

- [GitHub Discussions](https://github.com/bandantonio/obsidian-apple-books-highlights-plugin/discussions)