For the complete documentation index, see llms.txt. This page is also available as Markdown.

Quick Add

Manually send history, ratings, and watchlist actions to one or more providers for titles watched outside your usual media server flow.

Quick Add lets you manually send actions for a movie or show.

Use it when playback happened outside your normal media server flow.

Quick Add is available in v0.9.18 and later.

Examples:

  • a cinema visit

  • travel or offline viewing

  • a missed scrobble

  • a title watched on another device

Instead of updating each provider one by one or using sync pairs. Quick Add sends one request to multiple configured providers.

What Quick Add can send

Quick Add supports these actions:

  • History

  • Watchlist

  • Rating

You can send:

  • one action only

  • or any combination of those actions

Quick Add opens the manual watched flow.

How to open Quick Add

Quick Add is available from the CrossWatch UI.

Depending on your device:

  • Desktop uses the Quick Add side launcher

  • Mobile uses the floating Quick Add button

Selecting Quick Add opens the manual watched dialog.

Step-by-step

1

1) Search for the title

Choose Movies or Shows.

Type the title into the TMDb search box.

Pick the correct result.

After selection, the item appears under Selected Item.

On mobile, the search area can collapse after selection.

2

2) Choose the action

In Actions, select one or more:

  • History

  • Watchlist

  • Rating

These actions are independent.

You can send history only, rating only, watchlist only, or any mix.

Action behavior

History

  • marks the item as watched on supported providers

Watchlist

  • adds the item to watchlists on supported providers

Rating

  • sends the chosen score to providers that support ratings

3

3) Set the watched date

If History is enabled, choose When Watched:

  • Today

  • Release date

  • Choose date

Today uses the current date and time.

Release date uses the TMDb release date or first air date.

Choose date lets you pick a custom date.

If History is off, this section stays disabled.

4

4) Set a rating

If Rating is enabled, choose a value with the rating control.

If Rating is off, the rating control is ignored.

5

5) Select providers

In Send To, select the configured providers that should receive the action.

Provider behavior:

  • only configured providers are shown

  • multi-instance providers are supported

  • capability badges can show History, Watchlist, and Rating support

  • media servers can appear in a separate group when relevant

Selection defaults

By default, no providers are selected.

If you used Quick Add before, CrossWatch restores your last provider selection when possible.

You can also use:

  • Use last

  • Select all

  • Clear

6

6) Send the action

Before sending, make sure you selected:

  • a title

  • at least one action

  • at least one provider

  • a rating value, if Rating is enabled

Then click Send to providers.

CrossWatch sends the selected action or actions to the selected providers.

Mobile behavior

On mobile:

  • the dialog uses a single-column layout

  • some sections can collapse to reduce scrolling

  • Send To starts collapsed by default

  • Quick Add is available as a floating action button

Tips

  • If a provider does not support one selected action, that action is skipped for that provider.

  • Reusing the remembered provider selection saves time.

  • Use Choose date for older manual entries.

  • Use Release date carefully. It reflects TMDb metadata, not when you personally watched it.

Limitations

  • Quick Add depends on TMDb search and metadata matching.

  • Provider support differs for history, watchlist, and ratings.

  • A provider can support one action and not another.

  • If Rating is enabled, you must select a valid score.

Last updated

Was this helpful?