https://github.com/scarvy/readwise-to-apple-notes
Export Readwise highlights to Apple Notes.
https://github.com/scarvy/readwise-to-apple-notes
apple-notes applescript readwise
Last synced: 12 months ago
JSON representation
Export Readwise highlights to Apple Notes.
- Host: GitHub
- URL: https://github.com/scarvy/readwise-to-apple-notes
- Owner: Scarvy
- License: apache-2.0
- Created: 2024-03-16T21:56:36.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-17T00:24:10.000Z (over 2 years ago)
- Last Synced: 2025-06-22T15:58:36.507Z (about 1 year ago)
- Topics: apple-notes, applescript, readwise
- Language: Python
- Homepage:
- Size: 295 KB
- Stars: 18
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# readwise-to-apple-notes
[](https://pypi.org/project/readwise-to-apple-notes/)
[](https://github.com/Scarvy/readwise-to-apple-notes/releases)
[](https://github.com/Scarvy/readwise-to-apple-notes/actions/workflows/test.yml)
[](https://github.com/Scarvy/readwise-to-apple-notes/blob/master/LICENSE)
Export Readwise highlights to Apple Notes.
## Installation
Install this tool using `pip`:
pip install readwise-to-apple-notes
## 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=.
For help, run:
readwise-to-apple-notes --help
You can also use:
python -m 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 labled "Readwise" if it does not exist. All highlights within a given book, article, document will be placed in the same note. See example below.
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=
Or a list of books:
readwise-to-apple-notes export --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 create a new virtual environment using `poetry`:
cd readwise-to-apple-notes
poetry install
Now install the dependencies and test dependencies:
poetry install --with=dev
To run the tests:
pytest