Skip to content

Troubleshooting

GrayTechGH edited this page Jun 1, 2026 · 1 revision

Troubleshooting

The Plugin Cannot Run

Check that Output is configured and that selected books have usable Goodreads data.

Cannot run error

No Books Were Written

Possible causes:

  • Selected books do not have grrating or grvotes.
  • The selected destination columns are not compatible.
  • Calibre rejected a field write.

Rating Type Is Disabled

If the Rating destination is a Calibre rating-type field, GRating Rebalancer locks Rating type to Star rating. Change Rating to -- None -- to choose a different type.

If Star rating is disabled, the selected Rating field cannot store star ratings. Change Rating to -- None -- to choose Star rating.

The Results Changed Between Runs

If no locked map is active, the rating-to-percentile curve can change as your library changes. Use a locked map for stable future results.

Series Correction Looks Unexpected

Series correction depends on available series metadata, Goodreads ratings, vote counts, and learned map data. If a book is missing vote counts or usable series information, it may receive no series-position penalty.

Clone this wiki locally