Clean Reads discussion

I would like to introduce a browser extension for Goodreads called Cleanreads which I have created inspired by the "Cleanreads Rating" idea posted some years ago here in this group.

Description:
The primary idea is that the extension searches for keywords in the description, top reviews and bookshelves, and rates the book clean between 0-100, while also collating search matches for manual review.

For example:


Due to how book data is found by Cleanreads extension, it can't be easily retrieved for view in lists, but the tool will cache any ratings loaded by the user previously, and allows manual loading of rating from a list view:


Another secondary functionality is the ability to mark books as "Clean" which adds it to a list which can then be exported and shared with others. In the future this could potentially also be centrally hosted so everyone can add to the same list, but that would probably require a lot of moderation.

Installation:
You can install the extension by going to the link here:
https://chrome.google.com/webstore/de...
This should work on Chrome, or any chrome based browser like Edge, Brave, Opera, etc.

Also, to start everyone off I have created a list of over 18,000 "clean" books grabbed from a ton of shelves and lists that contained supposedly clean books. This can be downloaded from the link below (right click -> Save As) and imported into the Cleanreads extension by going to the extension settings and clicking on the "Import List" button.
https://raw.githubusercontent.com/Her...
Note, importing will merge any new books being imported with your current list, not replace the whole list.

You can also create your own lists by adding any book from its Goodreads page, or by grabbing books from shelves in the Cleanreads extension settings. Feel free to share these lists with the community. Also, you can suggest updates to the example list if you find books that should not be marked as clean.

Instructions:
To view a book's Cleanreads rating, simply navigate to the book's page on Goodreads and it should automatically load. You can also view ratings from a search or list view by clicking the "Load" button (or any previously cached ratings or books in the Clean book list will show up automatically). To disable Cleanreads or view the Cleanreads settings, click on the Extension icon in your browsers extensions. There should be a toggle to disable the extension and a link for settings.

The Cleanreads browser extension is pretty simple to use around the Goodreads website, but contains some kind of complicated settings. These settings let you import/export clean book lists, load Goodreads shelves, lists, and genres into your clean book list, and change the search parameters Cleanreads uses to determine book ratings. You can also specify how long snippets of comments should be in the Cleanreads rating view, and clear the locally stored book ratings cache.

I can potentially make a video tutorial on how the whole extension works in the future if people find this tool useful. Frankly, I'm not sure how much time I have to fix any bugs or make any updates, but I have used a version of this tool for years now and rely upon it a lot in my Goodreads wanderings.

If you found this helpful, please do leave any suggestions or comments on this thread and share with others! Thanks!
Also, the code is available on Github if anyone would like to help contribute to the project. The sample clean book list is also hosted in this Github repository so feel free to propose changes to the default list or add new example lists:
https://github.com/HermanFassett/clea...

Note, this is an extended update to a userscript I made previously and should be used instead.

I am amazed! What a useful tool. I'm sure there'll be hundreds of thousands who will find this helpful. I'm just going to take a look at a few books now and see if I can find mine!

Wow! I am not sure about my tech savvy to use this, but super grateful for your time and effort and will give it a try!

this is fantastic, thank you!

Fir some reason I’m missing part of the original message. It stops at “For Example”. Can someone please share more on the extension? Thank you!

Can you please explain how to get this extension?

Jen wrote: "Fir some reason I’m missing part of the original message. It stops at “For Example”. Can someone please share more on the extension? Thank you!"

Huh that's odd. Here's a link with some basic info including download links and screenshots:
https://github.com/HermanFassett/clea...

Linda wrote: "Can you please explain how to get this extension?"

You can visit the Chrome Web Store below:
https://chrome.google.com/webstore/de...

Then you should be able to "Add to" your browser; most browsers should work except Firefox that I'm aware of. After you click add button it should be automatically installed and ready to go if you just use the default settings.

Thank you so much for your help!

Such a helpful resource. Thanks again!

this is amazing!!! Thank you! I especially appreciate the flexibility and ease of use.

when I try to use the extension it doesn't work anymore I think this is because Goodreads updated there site.

Does this only work in chrome?

yeah, it looks like the update broke the extension :'(
Does anyone have any plans to fix it?

Please fix it! I would love to use it!

Gpop wrote: "when I try to use the extension it doesn't work anymore I think this is because Goodreads updated there site."

Ah I just saw this, I'll take a look at it and try to fix.

Marie wrote: "Does this only work in chrome?"

Yes, I've only tested it and released it on chrome store (so it should work for any chrome based browsers like Edge, Brave, Opera, Vivaldi), but not for Firefox at this point.

R wrote: "yeah, it looks like the update broke the extension :'(
Does anyone have any plans to fix it?"

Can I get more information? I did some basic testing in my browser and it was running fine.

Thank you so much for following up! The extension does not appear on the new book page. I do see it on pages with lists. I am using Chrome.

R wrote: "Thank you so much for following up! The extension does not appear on the new book page. I do see it on pages with lists. I am using Chrome."

Thanks for clarifying, it looks like they are slowly rolling out the update to users and I don't have it yet which was confusing me. I'll try some other locations and devices for the update when I get a chance.

Is there a possibility to submit books that may not be listed yet for the clean reads rating? If so is there a rating list to go off of?

R wrote: "Thank you so much for following up! The extension does not appear on the new book page. I do see it on pages with lists. I am using Chrome."

I have released an update which should temporarily work on the new book page. Goodreads hasn't finished rolling out the update so this may stop working for some people/everyone as the update is finished.

Lauren wrote: "Is there a possibility to submit books that may not be listed yet for the clean reads rating? If so is there a rating list to go off of?"

The rating score is based off the book's description, genres, shelves, and reviews so it's calculated on the fly. However, you can add to Clean List to force score of 100. Currently the list is local to your browser extension, but it can be exported/imported in the settings. I have an exported Clean List of 18,000 automatically rated books that can be found in the original post. If you'd like to add or remove from that list I can update it manually, but there's no other way to share books you've rated clean at this point. I've considered setting up some sort of centralized tool to share ratings but not sure at this point.

Herman wrote: "Lauren wrote: "Is there a possibility to submit books that may not be listed yet for the clean reads rating? If so is there a rating list to go off of?"

The rating score is based off the book's de..."

Thanks for responding. So far I like what I've seen.

Herman wrote: "R wrote: "Thank you so much for following up! The extension does not appear on the new book page. I do see it on pages with lists. I am using Chrome."

I have released an update which should tempor..."

Yay! Thanks so much! I still hate the new book page, but at least it's useful again.

Just a note on this for anyone who had this installed before the goodreads update. I had to uninstall the extension and then reinstall it before it worked.

Thank you once again for this amazing resource.