Download the PHP package osteel/kobwise without Composer
On this page you can find all versions of the php package osteel/kobwise. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download osteel/kobwise
More information about osteel/kobwise
Files in osteel/kobwise
Package kobwise
Short Description Convert your Kobo annotations to Readwise highlights
License GPL-3.0-only
Homepage https://github.com/osteel/kobwise
Informations about the package kobwise
kobwise
Convert your Kobo annotations to Readwise highlights
Why?
Readwise 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.
Readwise integrates with various services and platforms to ease the process of importing highlights, but unfortunately it is not compatible with Kobo.
kobwise 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.
Instal
kobwise is written in PHP and is installed using Composer:
Make sure the ~/.composer/vendor/bin
directory is in your system's PATH
.
Show me how
If it's not already there, add the following line to your Bash configuration file (usually `~/.bash_profile`, `~/.bashrc`, `~/.zshrc`, etc.): If the file doesn't exist, create it. Run the following command on the file you've just updated for the change to take effect:Use
All you need to do is call the convert
command on the annotation file:
It will create a new .csv
file in the current folder, which you can then upload to Readwise.
A help menu is also available upon running kobwise
with no arguments:
Update and delete
Update kobwise:
Delete kobwise:
Known limitations
Kobo'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.
It is therefore recommended to skim through the annotation file beforehand, and to delete any empty lines between paragraphs that should belong together.
As Readwise doesn't allow its users to permanently delete highlights, it is also recommended to review the .csv
file before import.
Wait. I can export my Kobo annotations?
For some reason, Kobo does not enable this option by default, and you need to manually update a configuration file to do so.
The steps are the following:
- Plug your Kobo to your computer
- Open the
eReader.config
file at the root of your Kobo - Add this line at the very end:
[FeatureSettings] ExportHighlights=true
- Save the file and eject your Kobo
- From your Kobo library, tap the three dots in front of the book you want to export annotations from
- Tap
Export Annotations
- Connect your Kobo to your computer again
- You should now see a
.txt
file at the root, containing the annotations
If you need more help, here is a detailed guide with screenshots.