{"id":13705180,"url":"https://github.com/osteel/kobwise","last_synced_at":"2025-05-05T15:49:02.057Z","repository":{"id":44553706,"uuid":"413103521","full_name":"osteel/kobwise","owner":"osteel","description":"Convert your Kobo annotations to Readwise highlights","archived":false,"fork":false,"pushed_at":"2023-01-08T15:23:40.000Z","size":3023,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-25T13:41:36.951Z","etag":null,"topics":["annotations","cli","composer","highlights","kobo","php","readwise"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/osteel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-03T14:38:25.000Z","updated_at":"2024-09-24T00:23:38.000Z","dependencies_parsed_at":"2023-02-08T06:31:22.427Z","dependency_job_id":null,"html_url":"https://github.com/osteel/kobwise","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osteel%2Fkobwise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osteel%2Fkobwise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osteel%2Fkobwise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osteel%2Fkobwise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osteel","download_url":"https://codeload.github.com/osteel/kobwise/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242741264,"owners_count":20177800,"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":["annotations","cli","composer","highlights","kobo","php","readwise"],"created_at":"2024-08-02T22:00:35.061Z","updated_at":"2025-03-09T19:31:48.352Z","avatar_url":"https://github.com/osteel.png","language":"PHP","funding_links":[],"categories":["Tools"],"sub_categories":["Kobo"],"readme":"\u003ch1 align=\"center\"\u003ekobwise\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eConvert your Kobo annotations to Readwise highlights\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"Preview\" src=\"/art/preview.png\"\u003e\n\t\u003cp align=\"center\"\u003e\n\t\t\u003ca href=\"https://github.com/osteel/kobwise/actions\"\u003e\u003cimg alt=\"Build Status\" src=\"https://github.com/osteel/kobwise/workflows/CI/badge.svg\"\u003e\u003c/a\u003e\n\t\t\u003ca href=\"//packagist.org/packages/osteel/kobwise\"\u003e\u003cimg alt=\"Latest Stable Version\" src=\"https://poser.pugx.org/osteel/kobwise/v\"\u003e\u003c/a\u003e\n\t\t\u003ca href=\"//packagist.org/packages/osteel/kobwise\"\u003e\u003cimg alt=\"License\" src=\"https://poser.pugx.org/osteel/kobwise/license\"\u003e\u003c/a\u003e\n\t\u003c/p\u003e\n\u003c/p\u003e\n\n## Why?\n\n[Readwise](https://readwise.io) is an application allowing you to import highlights from books, articles, or any source of content you find inspiring and/or worth remembering. It will then resurface these highlights at a frequency of your choosing.\n\nReadwise integrates with various services and platforms to ease the process of importing highlights, but unfortunately it is [not compatible with Kobo](https://help.readwise.io/article/82-does-readwise-support-kobo-highlights).\n\nkobwise is a small command-line application offering a bridge between the two, converting your Kobo annotations to a `.csv` file that is [compatible with Readwise](https://readwise.io/import_bulk).\n\n## Instal\n\nkobwise is written in PHP and is installed using [Composer](https://getcomposer.org):\n\n```\ncomposer global require osteel/kobwise\n```\n\nMake sure the `~/.composer/vendor/bin` directory is in your system's `PATH`.\n\n\u003cdetails\u003e\n\u003csummary\u003eShow me how\u003c/summary\u003e\n\nIf it's not already there, add the following line to your Bash configuration file (usually `~/.bash_profile`, `~/.bashrc`, `~/.zshrc`, etc.):\n\n```\nexport PATH=~/.composer/vendor/bin:$PATH\n```\n\nIf the file doesn't exist, create it.\n\nRun the following command on the file you've just updated for the change to take effect:\n\n```\nsource ~/.bash_profile\n```\n\u003c/details\u003e\n\n## Use\n\nAll you need to do is call the `convert` command on the annotation file:\n\n```\nkobwise convert \"The Almanack of Naval Ravikant.txt\"\n```\n\nIt will create a new `.csv` file in the current folder, which you can then [upload to Readwise](https://readwise.io/import_bulk).\n\nA help menu is also available upon running `kobwise` with no arguments:\n\n```\nkobwise\n```\n\n## Update and delete\n\nUpdate kobwise:\n\n```\ncomposer global update osteel/kobwise\n```\n\nDelete kobwise:\n\n```\ncomposer global remove osteel/kobwise\n```\n\n## Known limitations\n\nKobo's annotation files are formatted in such a way that it is not easy to distinguish separate annotations from different paragraphs belonging to the same annotation.\n\nIt is therefore recommended to skim through the annotation file beforehand, and to delete any empty lines between paragraphs that should belong together.\n\nAs Readwise doesn't allow its users to [permanently delete highlights](https://help.readwise.io/article/123-why-cant-i-permanently-delete-highlights), it is also recommended to review the `.csv` file before import.\n\n## Wait. I can export my Kobo annotations?\n\nFor some reason, Kobo does not enable this option by default, and you need to manually update a configuration file to do so.\n\nThe steps are the following:\n\n1. Plug your Kobo to your computer\n2. Open the `eReader.config` file at the root of your Kobo\n3. Add this line at the very end: `[FeatureSettings] ExportHighlights=true`\n4. Save the file and eject your Kobo\n5. From your Kobo library, tap the three dots in front of the book you want to export annotations from\n6. Tap `Export Annotations`\n7. Connect your Kobo to your computer again\n8. You should now see a `.txt` file at the root, containing the annotations\n\nIf you need more help, here is a [detailed guide](https://www.epubor.com/export-kobo-highlights-and-notes.html) with screenshots.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosteel%2Fkobwise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosteel%2Fkobwise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosteel%2Fkobwise/lists"}