{"id":20208427,"url":"https://github.com/scarvy/apple-notes-readwise","last_synced_at":"2025-06-22T12:06:43.266Z","repository":{"id":262759317,"uuid":"881210845","full_name":"Scarvy/apple-notes-readwise","owner":"Scarvy","description":"Export Readwise highlights to Apple Notes","archived":false,"fork":false,"pushed_at":"2025-06-05T20:23:11.000Z","size":11271,"stargazers_count":7,"open_issues_count":7,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-15T05:07:51.679Z","etag":null,"topics":["apple","apple-notes","readwise","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.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,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-10-31T05:32:50.000Z","updated_at":"2025-04-25T19:52:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"67cdafe0-68f0-417c-8c2f-f59aae1a4375","html_url":"https://github.com/Scarvy/apple-notes-readwise","commit_stats":null,"previous_names":["scarvy/apple-notes-readwise"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/Scarvy/apple-notes-readwise","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Fapple-notes-readwise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Fapple-notes-readwise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Fapple-notes-readwise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Fapple-notes-readwise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Scarvy","download_url":"https://codeload.github.com/Scarvy/apple-notes-readwise/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scarvy%2Fapple-notes-readwise/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261289418,"owners_count":23136070,"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","apple-notes","readwise","typescript"],"created_at":"2024-11-14T05:35:32.929Z","updated_at":"2025-06-22T12:06:38.253Z","avatar_url":"https://github.com/Scarvy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Readwise 📚 to Apple Notes Export 📥\n\n\u003e [!WARNING]\n\u003e ⚠️ **Please note that this product is currently in early development, and you may encounter some issues during use or while syncing.** \n\u003e \n\u003e We are actively working towards a stable release and greatly appreciate your feedback. We welcome early beta testers to help us improve the app. \n\u003e \n\u003e If you experience any problems, please feel free to submit an issue. Pull requests are also welcome! \n\u003e \n\u003e Your contributions are invaluable as we work towards delivering a more reliable experience. Thank you for your support! ⚠️\n\nThis 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.\n\n\u003e [!NOTE]\n\u003e This app requires a subscription with [Readwise](https://readwise.io/) - a paid service that makes it easy to aggregate and review all your reading data into one place.\n\n## Features\n\n- **Customize Formatting** 💅: - use Readwise's formatting tool to change how the note appears in Apple Notes.\n- **Multi-Account Support** 👥: Select from multiple Apple Notes accounts (e.g. iCloud, Gmail).\n- **Folder Management** 📁: Automatically create and verify folders in Apple Notes.\n- **Automatic Syncing** 🔄: Configure the frequency of when new highlights are added.\n\n## Installation\n\n1. Go to [https://readwise.io/apple_notes](https://readwise.io/apple_notes/start).\n\n---\n\n## Usage\n\n1. **Launch the App:** Start the application after installation.\n2. **Select Account:** Choose your Apple Notes account from the dropdown menu (e.g., iCloud, Gmail).\n3. **Specify Folder:**\n   - Enter the name of the folder where notes will be imported.\n   - If the folder doesn’t exist, it will be created.\n4. **Pick a sync frequency:**\n   - Use the select box to pick a frequency your want your highlights to re-sync. (e.g. `Every 1 Hour`, `Every 12 Hours` etc.)\n5. **Initiate Sync:** Click the 'Initiate Sync' button to start the sync process. You'll get messages on the progress of the current sync.\n6. **Success Notification:** Once completed, you’ll receive a success message.\n\n---\n\n## Screenshots\n\n![main-screen](/screenshots/app-and-apple-notes.png)\n\nTrack sync progress\n\n![sync-highlights-progress](/screenshots/sync-highlights-progress.png)\n\nUpdate sync frequency\n\n![update-sync-frequency](/screenshots/update-sync-frequency.png)\n\nSelect account\n\n![select-account](\u003c/screenshots/select-account.png\u003e)\n\n## Demo\n\n![demo](/screenshots/apple-notes-readwise-demo.gif)\n\n## Development Setup\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/Scarvy/apple-notes-readwise.git\n   cd \u003crepo\u003e\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Run the app in development mode:\n   ```bash\n   npm start\n   ```\n\n4. Build the app for production:\n   ```bash\n   npm run make\n   ```\n\n---\n\n## Technical Details\n\n### Built With\n\n- [Electron](https://www.electronjs.org/)\n- [TypeScript](https://www.typescriptlang.org/)\n- [AppleScript](https://en.wikipedia.org/wiki/AppleScript)\n\n---\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch:\n   ```bash\n   git checkout -b feature-name\n   ```\n3. Commit your changes:\n   ```bash\n   git commit -m \"Add feature\"\n   ```\n4. Push to the branch:\n   ```bash\n   git push origin feature-name\n   ```\n5. Submit a pull request.\n\n---\n\n## Known Limitations\n\n- Only supports macOS due to reliance on AppleScript.\n- Requires the Apple Notes app to be installed and configured.\n\n---\n\n## License\n\nThis project is licensed under the [GNU GENERAL](LICENSE).\n\n---\n\n## Contact\n\nFor any issues or feature requests, please open an issue on the [GitHub Issues](https://github.com/Scarvy/apple-notes-readwise/issues) page.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscarvy%2Fapple-notes-readwise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscarvy%2Fapple-notes-readwise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscarvy%2Fapple-notes-readwise/lists"}