> 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 FlickList adapter notes for syncing watchlist, ratings, history, progress, playlists, and collections. ## 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 | | Collection | Yes | Yes | Movies, Shows | 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._write_batch_size flicklist.timeout ``` For normal use, keep the defaults unless FlickList returns rate limit errors. --- # 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/synchronization/trackers/flicklist.md?ask=&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.