> 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/synchronization/trackers/flicklist.md).

# FlickList

## Adapter: FlickList

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

{% hint style="warning" %}
The adapter is currently **experimental**.
{% endhint %}

### 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.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wiki.crosswatch.app/crosswatch/settings/synchronization/trackers/flicklist.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.