> For the complete documentation index, see [llms.txt](https://wiki.crosswatch.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.crosswatch.app/crosswatch/settings/connections/media-clients/kodi/kodi-add-on/ratings.md).

# Ratings

After a finished episode or film, the add-on can ask for a score. CrossWatch sends it to connected rating services.

This needs CrossWatch v0.13.4 or later.

### Enable ratings

In add-on settings, open **Viewers** and set **Ask for a rating** to **Films**, **Episodes**, or **Films and episodes**.

* **When to ask**: ask after each watch, or collect questions until playback stops.
* **Shared rating**: ask one shared question rather than one per viewer.
* **Write the rating to Kodi's library**: also set Kodi's user rating.

### When Kodi asks

Kodi asks only after a finished watch. This means the item ended or passed Kodi's watched threshold, which is 90% by default. It asks after the who-watched question.

With **After each watch**, autoplayed episodes are not rated. With **At the end, for everything watched**, Kodi asks about each finished watch when playback ends. Closing Kodi drops unanswered questions.

Kodi skips rating if the viewer question was skipped or timed out, a viewer was removed, another dialog is open, Kodi is shutting down, or the playback is not reported.

### Give a score

With shared ratings off, each credited viewer receives a question. With it on, one score goes to every viewer. A playback with no viewer receives one unassigned question.

Press **OK** on a score to send it. **Remove rating** asks CrossWatch to remove that person's score. **Skip**, **Back**, or one minute of inactivity sends nothing.

| Score | Word     | Score | Word        |
| ----- | -------- | ----- | ----------- |
| 1     | Awful    | 6     | Fair        |
| 2     | Very bad | 7     | Good        |
| 3     | Bad      | 8     | Great       |
| 4     | Poor     | 9     | Superb      |
| 5     | Average  | 10    | Masterpiece |

Starting playback closes the window and cancels remaining questions.

### Kodi library rating

When enabled, the add-on writes Kodi's user rating for library items. Kodi has one rating per item. It writes only when every submitted score agrees, or one viewer submits a score and others skip. **Remove rating** clears Kodi's rating if no score remains.

On a shared MySQL or MariaDB library, every profile and device sees the same user rating.

### Destinations

CrossWatch chooses destinations. The add-on does not.

| Destination                                                                            | Films | Episodes | Note                                                                 |
| -------------------------------------------------------------------------------------- | ----- | -------- | -------------------------------------------------------------------- |
| Trakt, Plex, MDBList, CrossWatch tracker, Floppy, Scrob, PunchPlay, FlickList, WeTrakr | Yes   | Yes      | Plex titles must be in its library. Floppy and Scrob need a TMDb ID. |
| Simkl                                                                                  | Yes   | No       |                                                                      |
| AniList, Kitsu, MyAnimeList                                                            | Yes   | No       | Scores the complete anime entry.                                     |
| Emby, Jellyfin, Kodi, BingeBase                                                        | No    | No       | These destinations do not accept ratings.                            |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.crosswatch.app/crosswatch/settings/connections/media-clients/kodi/kodi-add-on/ratings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
