FlickList

FlickList adapter notes for syncing watchlist, ratings, history, progress, and playlists.

Adapter: FlickList

FlickList can be used as both a source and target in CrossWatch sync pairs.

The adapter is currently experimental.

What it supports

Feature	Read	Write	Media types
Watchlist	Yes	Yes	Movies, Shows
Ratings	Yes	Yes	Movies, Shows, Episodes
History	Yes	Yes	Movies, Episodes
Progress	Yes	Yes	Movies, Episodes
Playlists	Yes	Yes	Movies, Shows, Episodes

FlickList can also be used as a scrobble target.

Prerequisite

Connect FlickList under Settings → Authentication → FlickList before using it in a pair.

Both Device Code and API Key authentication are supported.

Sync behavior

FlickList uses present-state snapshots. CrossWatch creates the initial baseline and processes changes on later runs.

The adapter supports:

• Add and remove operations
• Observed deletes
• Multiple FlickList profiles
• Bidirectional sync where the selected feature and paired provider support it

Matching

FlickList accepts these IDs for writes:

• FlickList ID, fldb
• TMDb
• IMDb
• TVDb

FlickList data can also expose AniList IDs for matching.

For episodes, CrossWatch needs the show-level ID with the season and episode number. Items without a usable show identity remain unresolved instead of being guessed.

Ratings

FlickList ratings use a 0.5 to 10 scale.

CrossWatch rounds ratings to the nearest half point when writing to FlickList.

Playlists

CrossWatch can:

• Read FlickList lists
• Create lists
• Add items
• Remove items

Playlist reordering is not supported.

FlickList smart lists are read only.

Rate limits

The default FlickList adapter limits are:

• Reads: 0.2 requests per second
• Writes: 0.2 requests per second
• Maximum write batch: 1000 items

Power users can tune these under:

flicklist.rate_limit.get_per_sec
flicklist.rate_limit.post_per_sec
flicklist.write_batch_size
flicklist.<feature>_write_batch_size
flicklist.timeout

For normal use, keep the defaults unless FlickList returns rate limit errors.

Current limitation

Collections are not currently exposed by the FlickList sync adapter.