📚 "SAMO" Goodreads Utility (version 2.6.3)

Bookmarklet that add some utilities to Goodreads site https://www.goodreads.com/

Table of contents

• Installation
• Utilities list
• Soon next features
• Versions history
• Known limitations and bugs
• Developers area

---

🔧 Installation

show Installation video (on iPad)

1. Add a 🔖 Bookmark "Goodreads Utility" to your browser

   • copy and paste this javascript code into the bookmark URL

     • by default this installation language is Italian

       samoGoodreadsUtility={'lang':'ita'}

     • you can change language by replacing the 'lang' value ita with one of this languages

     javascript:var samoGoodreadsUtility={'lang':'ita'};(function(){var s=document.createElement('SCRIPT');s.type='text/javascript';s.src='https://asamorini.github.io/goodreads.utility/dist/goodreads.utility.min.js';document.getElementsByTagName('head')[0].appendChild(s);})();
     

2. and now, when you are visiting www.goodreads.com/ site
   • if you click the bookmark "Goodreads utility" a new menu will be shown
   • click on it to see utilities

Notes:

• 💡 if you are synchronizing web browser bookmarks between your devices (example: pc and mobile phone and tablet), you need to install only on one browser
• 💡 after you have installed on your browser, you always use the last version, and receive automatically updates (so to become aware of new features, connected to this site)
• 💡 how I can be updated of new features? From the new menù, near the title "GOODREADS UTILITY" the current version is showed, you can click it to open this documentation page, and check Versions history

---

✔️ Utilities List

• Books list: replace books to the corresponding edition of specific language
  • Author page - show demo video
    • author's books list
  • Books by author page - show demo video
    • author's books list
  • Listopia pages (Listopia and Listopia voted by user...) - show demo video
    • books of this list
  • Recommendations pages (Recommendations,Recommendations by shelf,Recommendations by genre) - show demo video
    • recommended books
  • Choice Awards - show demo video
    • "Nominees on your shelves" books list
  • Choice Awards Category - show demo video
    • "Winner" book
    • "All nominees" books list
  • Book page - show demo video
    • "Books by author" books list
    • "Readers also enjoyed" books list
• Book page: search for editions of specific language show demo video
  • when you are on a BOOK page, you can find list of specific language editions
• My Books page: bookshelves viewer
  • when you are on MY BOOKS page, you can navigate, search and filter those shelves (by years\stars\num.pages\shelves\authors; after first data calculation, all filter you apply are on your browser)
    • Read: useful for statistics show demo video
    • Want to Read: useful to choose the next book to read show demo video

---

🔜 Next features

• book page-search language editions
  • sort
    • default by year\publisher
    • possibility to change by year
  • language
    • possibility to include editions without language defined (checkbox, default included, they must be evidenced in some way)
• Books list: replace books to the corresponding edition of specific language
  • also on those list
    • Giveaways
    • New Releases
    • other user bookshelves
    • Books similar to ... page (link "Readers also enjoyed" of book page)
    • Favorite genres
    • Favorite genres\Shelf; example: https://www.goodreads.com/shelf/show/art-books-monographs
  • replacing info
    • book description not already replaced
    • tooltip info replacement also in Choice awards
    • image has poor quality on "Choice awards" and "Recommendations" with View mode=cover
    • red icon for previously replaced book must be resetted if we change language and start another replacement
• help link on menu
• reviews
  • filter to show only italian ones
• bookshelves viewer
  • bookshelves list
    • tree representation\aggregation, ex for my library
      • g-Genre 999
        • Art 150
        • Assay 159
        • Biography 263
        • ...
      • w-World 999
        • Africa 67
          • Algeria 23
          • ...
  • books list
    • books column: click to sort
    • add tooltipTrigger on hover book thumbnail like in original list
• citations (inside "SAMO Goodreads utility" menù)
  • from public site's citations
    • in language (defined in "SAMO Goodreads utility" installation language)
  • button to refresh\load another one

---

📅 Versions history

Date	Version	Improvement
2018.12.09	1.0	Search for book editions on specific language (Italian)
2018.12.30	1.1	Language selection
2019.01.01	1.2	Replace books on list to specific language (on page Authors,Authors book,Choice Awards,Choice Awards Category)
2019.01.04	1.3	Replace books on list to specific language (on page Listopia,Listopia votes of ...)
		Showed current version near the title
2019.01.05	1.4	Replace books on list to specific language (on page Recommendations,Recommendations based by shelf,Recommendations based by genre)
		Replace books on list to specific language (added red icon over images of replaced books)
2019.01.13	1.5	Replace books on list to specific language (on page Book)
2019.01.20	1.6	Replace books on list to specific language (added total searched info on counter; added checkbox "Hide books not found")
2019.01.20	1.7	Bookshelves viewer
2019.01.23	1.8	Bookshelves viewer (increased speed, added sequence number on books list, added tooltip on mouseover of shelves that show number of read books per years, added possibility to exclude shelves)
2019.01.24	1.9	Search for book editions on specific language (possibility to filter book format, ex: paperback\ebook\audiobook...)
2019.02.03	2.0	Bookshelves viewer (added conditions between shelves buttons "AND\OR", and possibility to and customizazion of shelves names display, added rating and authors filters)
2019.02.08	2.1	Bookshelves viewer (added num pages filter, and search book and reset filter buttons)
2019.03.11	2.2	Bookshelves viewer (authors sorted by books number and then by name)
2021.12.30	2.3	Bookshelves viewer (added "Create report by year" functionality)
2022.01.01	2.4	Bookshelves viewer (substitution of num.pages from other editions for audiobook\undedined pages)
2022.01.03	2.5	Bookshelves viewer (added color scale background on counters)
2022.01.30	2.5.1	Bookshelves viewer (analyze bookshelves of other user, with the exception of shelves distribution)
2022.07.15	2.5.2	Bookshelves viewer (added monthes filter)
2023.01.29	2.6	Book page (Find Italian[other languages] Editions of current book -> now compatible with new goodreads book page version)
2023.02.06	2.6.1	Book page (Find Italian[other languages] Editions of current book -> button "Switch to" available also on "Current readings books")
2023.02.07	2.6.2	Authors page (Find Italian[other languages] Editions of current books -> enabled with the new goodreads book version
2025.01.14	2.6.3	Bookshelves viewer (improvement on substitution of num.pages from other editions for audiobook\undedined pages)

---

🙉 Known limitations and bugs 🐛

• It works only on desktop version of the site
• Layout is verified only for window larger than 600px

---

🚧 Developers area

• GITHUB better organization
  • beautify readme https://help.github.com/articles/basic-writing-and-formatting-syntax/
  • create a "how it works" documentation
  • italian documentation version too
  • demo video: reduce size and upload on github (max 25mb limit)
• code improvements, next steps
  • externalize citations in separate file
  • intenazionalization messages and labels
  • create a Chrome extension
  • write ES6 code