[plugin] Hardcover.app syncing

[Billiam]

Hi everybody!

I've recently released hardcoverapp.koplugin, a plugin to update your reading status on https://hardcover.app.

Features

• Search Hardcover to link your document to a hardcover book and/or edition
• Mark books as to-read, reading, finished, did not finish
• Add/update your book rating
• Update book privacy setting
• Update your reading progress (page number)
• Create manual journal entry notes
• Highlight text to create a journal entry quote
• (optionally) automatically update your reading progress while reading
• (optionally) automatically mark books as finish when done

(not implemented, maybe some day):

• Update dates read
• Add/edit reviews
• Adding books to lists

Install, instructions, etc: https://github.com/Billiam/hardcoverapp.koplugin

Tested with:

* KOReader 2024.07 and 2024.11
* Kobo Clara HD

[Ebookus]

this seems pretty interesting, the only question I have is: why not try and make it part of KOReader's official plugins?

[Billiam]

Originally Posted by Ebookus

this seems pretty interesting, the only question I have is: why not try and make it part of KOReader's official plugins?

Official plugins are maintained by koreader. I don't think they're looking to expand that list/maintenance.

Also, it currently requires external setup (adding an API key), which no other official plugins require.Hardcover may be changing their API access to oauth at some point though, so the requirements may change.

I'll be submitting it to the third party plugin list at some point: https://github.com/koreader/contrib

[gereksizuser]

Thanks for the plugin, it works fine on the Aura 2. Is it possible to add hardcover options (to read, currently reading, read, etc.) to the menu that appears when we long press on a book? I hope more features will come to the site soon, it would be nice to be able to set the reading percentage etc.

[Billiam]

Originally Posted by gereksizuser

Is it possible to add hardcover options (to read, currently reading, read, etc.) to the menu that appears when we long press on a book?

Unfortunately, this isn't available for modification by plugin developers (as far as I can tell). I've opened a feature request to make this available, so perhaps it can be added in some future version of KOReader.

Originally Posted by gereksizuser

it would be nice to be able to set the reading percentage

I think you can set your reading progress by page or percentage on hardcover currently, though I don't have any percentage options in the plugin

[gereksizuser]

Originally Posted by Billiam

I think you can set your reading progress by page or percentage on hardcover currently, though I don't have any percentage options in the plugin

Ahh, I wrote without examining the site enough , as you said, the percentage of books can be adjusted with the scroll bar. I guess I'm too used to the goodreads settings.

[AlphaT]

This looks great and I've tried to install it on my Kindle PW5. I think i've followed the instructions correctly and have tested my API key. The Hardcover plugin menu just isn't there in the Bookmark menu. What could I have done wrong? I've left the folder name as 'hardcoverapp.koplugin-main' in the KO plugin folder, is that correct?
Thanks

[Billiam]

Originally Posted by AlphaT

I've left the folder name as 'hardcoverapp.koplugin-main' in the KO plugin folder, is that correct?

Hi. No, the folder name should be "hardcoverapp.koplugin"

[zikasak]

It should have an ability to work offline for a further sync. otherwise, even hardcover quotes can't be done while you are not connected (which is often for ereaders). Also an ability to push koreader highlights to hardcover would be nice to have

[Billiam]

Some kind of queue for offline use would be nice to have.

Originally Posted by zikasak

Also an ability to push koreader highlights to hardcover would be nice to have

How do you envision that working?

[zikasak]

Originally Posted by Billiam

How do you envision that working?

probably the same way as a official koreader.export plugin works?

I see it is possible to add a new destination type to highlights export https://github.com/fairlygood/provid...ights.koplugin

[Billiam]

Would you expect highlights to be treated as quotes in Hardcover? I assume you mean in lieu of the current 'hardcover quote' button

[Johnmeowvin]

the plugin in won't shown in my pw5. i already tried clean install of koreader. it has proper folder name yet, it won't show. meanwhile, i tried the new zlib plugin and it appeared in an instant. any help please?

[kodermike]

Originally Posted by Johnmeowvin

the plugin in won't shown in my pw5. i already tried clean install of koreader. it has proper folder name yet, it won't show. meanwhile, i tried the new zlib plugin and it appeared in an instant. any help please?

(just another user, ignore me if bill responds) Is there anything in your crash.log? I'm not 100% positive about the exact path on kindle installs, but it should be at the top level of the koreader install. Koreader is pretty good about recovering from crashes (believe me, I've put it through the paces lately) and will silently throw an error message in the log if it fails to load a plugin usually.

[Johnmeowvin]

Originally Posted by kodermike

(just another user, ignore me if bill responds) Is there anything in your crash.log? I'm not 100% positive about the exact path on kindle installs, but it should be at the top level of the koreader install. Koreader is pretty good about recovering from crashes (believe me, I've put it through the paces lately) and will silently throw an error message in the log if it fails to load a plugin usually.

it's working now. had an issue with the config file