readwise-to-apple-notes

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #go #android #machine-learning #deep-learning #awesome #cli #vue #pytorch #mcp #ios

readwise-to-apple-notes

(★ 20)

Export Readwise highlights to Apple Notes.

readwise-to-apple-notes Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# readwise-to-apple-notes

[![PyPI](https://img.shields.io/pypi/v/readwise-to-apple-notes.svg)](https://pypi.org/project/readwise-to-apple-notes/)
[![Changelog](https://img.shields.io/github/v/release/Scarvy/readwise-to-apple-notes?include_prereleases&label=changelog)](https://github.com/Scarvy/readwise-to-apple-notes/releases)
[![Tests](https://github.com/Scarvy/readwise-to-apple-notes/actions/workflows/test.yml/badge.svg)](https://github.com/Scarvy/readwise-to-apple-notes/actions/workflows/test.yml)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/Scarvy/readwise-to-apple-notes/blob/master/LICENSE)

Export Readwise highlights to Apple Notes.

![apple-notes-readwise-folder](https://raw.githubusercontent.com/Scarvy/readwise-to-apple-notes/main/images/apple-notes-readwise-folder.png)

## Installation

Install this tool using `uv`:

uv add readwise-to-apple-notes

Or add install it as a tool:

uv tool install readwise-to-apple-notes

then run:

readwise-to-apple-notes export

## Usage

> [!IMPORTANT]
> First, obtain a Readwise access token. Then, the token has to be stored, either into an .env file or an environment variable using export READWISE_TOKEN=<your_token>.

For help, run:

readwise-to-apple-notes --help

You can also use:

uv run readwise-to-apple-notes --help

### Export

> [!NOTE]
> When you first run the `export` command. The script will create a new folder in your Apple Notes labeled "Readwise" if it does not exist. All highlights within a given book, article, document will be placed in the same note. See example below.

![readwise-apple-note-example](https://raw.githubusercontent.com/Scarvy/readwise-to-apple-notes/main/images/readwise-apple-note-example-v2.png)

Export all highlights:

readwise-to-apple-notes export

You should see progress bars for each document and the number of highlights to be written to a new Apple Note.

readwise-to-apple-notes export

Exporting highlights  [####################################]  28/28 100% 
    Exporting highlights  [####################################]  10/10  100%         
    Exporting highlights  [####################################]  21/21  100%

Export after a specific date:

readwise-to-apple-notes export --updated-after 2024-03-15

Export a single books highlights:

readwise-to-apple-notes export --book-id=<user_book_id>

Or a list of books:

readwise-to-apple-notes export --book-id=<user_book_id>,<another_book_id>

### Additional Commands

When you need to look up a`book_id`, run:

readwise-to-apple-notes books
    
    {
        "id": 29932193,
        "title": "Thinking, Fast and Slow",
        "author": "Daniel Kahneman",
        "category": "books",
        "num_highlights": 2,
        "source": "kindle",
        "document_note": "",
        "document_tag": ""
    }
    ...
    {
        "id": 29931089,
        "title": "How to Use Readwise",
        "author": "Readwise Team",
        "category": "books",
        "num_highlights": 62,
        "source": "native",
        "document_note": "",
        "document_tag": "readwise"
    }

If you know the `book_id` and want to check a book's details, run:

readwise-to-apple-notes book 29932193

{
        "id": 29932193,
        "title": "Thinking, Fast and Slow",
        "author": "Daniel Kahneman",
        "category": "books",
        "source": "kindle",
        "num_highlights": 2,
        "last_highlight_at": "2016-08-03T04:56:00.000000Z",
        "updated": "2023-07-10T00:56:27.463529Z",
        "cover_image_url": "https://images-na.ssl-images-amazon.com/images/I/41shZGS-G%2BL._SL200_.jpg",
        "highlights_url": "https://readwise.io/bookreview/29932193",
        "source_url": null,
        "asin": "B00555X8OA",
        "tags": [],
        "document_note": ""
    }

### API Reference

Usage: readwise-to-apple-notes [OPTIONS] COMMAND [ARGS]...

Export Readwise Highlights to Apple Notes.

Options:
    --version  Show the version and exit.
    --help     Show this message and exit.

Commands:
    book
    books
    export

## Development

To contribute to this tool, first checkout the code. Then run `uv sync`:

cd readwise-to-apple-notes
    uv sync

Now install the dependencies and test dependencies:

uv sync --group dev

To run the tests:

uv run pytest

readwise-to-apple-notes

readwise-to-apple-notes Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

readwise-to-apple-notes

readwise-to-apple-notes Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README