{"id":20208440,"url":"https://github.com/scarvy/readwise-to-apple-notes","last_synced_at":"2025-07-07T11:06:14.832Z","repository":{"id":228091436,"uuid":"773147896","full_name":"Scarvy/readwise-to-apple-notes","owner":"Scarvy","description":"Export Readwise highlights to Apple Notes.","archived":false,"fork":false,"pushed_at":"2024-03-17T00:24:10.000Z","size":302,"stargazers_count":18,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-22T15:58:36.507Z","etag":null,"topics":["apple-notes","applescript","readwise"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Scarvy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-03-16T21:56:36.000Z","updated_at":"2025-02-27T14:08:17.000Z","dependencies_parsed_at":"2024-03-17T04:14:09.043Z","dependency_job_id":"2effb7af-9aaa-4557-9894-447ecc7dd38e","html_url":"https://github.com/Scarvy/readwise-to-apple-notes","commit_stats":null,"previous_names":["scarvy/readwise-to-apple-notes"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Scarvy/readwise-to-apple-notes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Freadwise-to-apple-notes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Freadwise-to-apple-notes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Freadwise-to-apple-notes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Freadwise-to-apple-notes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Scarvy","download_url":"https://codeload.github.com/Scarvy/readwise-to-apple-notes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Freadwise-to-apple-notes/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261320429,"owners_count":23140938,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple-notes","applescript","readwise"],"created_at":"2024-11-14T05:35:39.316Z","updated_at":"2025-07-07T11:06:14.768Z","avatar_url":"https://github.com/Scarvy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# readwise-to-apple-notes\n\n[![PyPI](https://img.shields.io/pypi/v/readwise-to-apple-notes.svg)](https://pypi.org/project/readwise-to-apple-notes/)\n[![Changelog](https://img.shields.io/github/v/release/Scarvy/readwise-to-apple-notes?include_prereleases\u0026label=changelog)](https://github.com/Scarvy/readwise-to-apple-notes/releases)\n[![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)\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/Scarvy/readwise-to-apple-notes/blob/master/LICENSE)\n\nExport Readwise highlights to Apple Notes.\n\n![apple-notes-readwise-folder](images/apple-notes-readwise-folder.png)\n\n## Installation\n\nInstall this tool using `pip`:\n\n    pip install readwise-to-apple-notes\n\n## Usage\n\n\u003e [!IMPORTANT]\n\u003e 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=\u003cyour_token\u003e.\n\nFor help, run:\n\n    readwise-to-apple-notes --help\n\nYou can also use:\n\n    python -m readwise-to-apple-notes --help\n\n### Export\n\n\u003e [!NOTE]\n\u003e 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.\n\n![readwise-apple-note-example](/images/readwise-apple-note-example-v2.png)\n\nExport all highlights:\n\n    readwise-to-apple-notes export\n\nYou should see progress bars for each document and the number of highlights to be written to a new Apple Note.\n\n    readwise-to-apple-notes export\n\n    Exporting highlights  [####################################]  28/28 100% \n    Exporting highlights  [####################################]  10/10  100%         \n    Exporting highlights  [####################################]  21/21  100%  \n\nExport after a specific date:\n\n    readwise-to-apple-notes export --updated-after 2024-03-15\n\nExport a single books highlights:\n\n    readwise-to-apple-notes export --book-id=\u003cuser_book_id\u003e\n\nOr a list of books:\n\n    readwise-to-apple-notes export --book-id=\u003cuser_book_id\u003e,\u003canother_book_id\u003e\n\n### Additional Commands\n\nWhen you need to look up a`book_id`, run:\n\n    readwise-to-apple-notes books\n    \n    {\n        \"id\": 29932193,\n        \"title\": \"Thinking, Fast and Slow\",\n        \"author\": \"Daniel Kahneman\",\n        \"category\": \"books\",\n        \"num_highlights\": 2,\n        \"source\": \"kindle\",\n        \"document_note\": \"\",\n        \"document_tag\": \"\"\n    }\n    ...\n    {\n        \"id\": 29931089,\n        \"title\": \"How to Use Readwise\",\n        \"author\": \"Readwise Team\",\n        \"category\": \"books\",\n        \"num_highlights\": 62,\n        \"source\": \"native\",\n        \"document_note\": \"\",\n        \"document_tag\": \"readwise\"\n    }\n\nIf you know the `book_id` and want to check a book's details, run:\n\n    readwise-to-apple-notes book 29932193\n\n    {\n        \"id\": 29932193,\n        \"title\": \"Thinking, Fast and Slow\",\n        \"author\": \"Daniel Kahneman\",\n        \"category\": \"books\",\n        \"source\": \"kindle\",\n        \"num_highlights\": 2,\n        \"last_highlight_at\": \"2016-08-03T04:56:00.000000Z\",\n        \"updated\": \"2023-07-10T00:56:27.463529Z\",\n        \"cover_image_url\": \"https://images-na.ssl-images-amazon.com/images/I/41shZGS-G%2BL._SL200_.jpg\",\n        \"highlights_url\": \"https://readwise.io/bookreview/29932193\",\n        \"source_url\": null,\n        \"asin\": \"B00555X8OA\",\n        \"tags\": [],\n        \"document_note\": \"\"\n    }\n\n### API Reference\n\n    Usage: readwise-to-apple-notes [OPTIONS] COMMAND [ARGS]...\n\n    Export Readwise Highlights to Apple Notes.\n\n    Options:\n    --version  Show the version and exit.\n    --help     Show this message and exit.\n\n    Commands:\n    book\n    books\n    export\n\n## Development\n\nTo contribute to this tool, first checkout the code. Then create a new virtual environment using `poetry`:\n\n    cd readwise-to-apple-notes\n    poetry install\n\nNow install the dependencies and test dependencies:\n\n    poetry install --with=dev\n\nTo run the tests:\n\n    pytest\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscarvy%2Freadwise-to-apple-notes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscarvy%2Freadwise-to-apple-notes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscarvy%2Freadwise-to-apple-notes/lists"}