> 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/floppy.md). # Floppy Floppy adapter lets CW synchronize with a Floppy server. It supports watchlist, ratings, history, and progress. {% hint style="info" %} Connect Floppy first. Use [Floppy (Authentication provider)](/crosswatch/settings/connections/trackers/floppy.md). {% endhint %} {% hint style="info" %} CW throttles Floppy requests to reduce server load. Defaults are `20` GET requests per second and `20` POST requests per second. See [Provider rate limiting](/crosswatch/advanced-and-api/rate-limiting-and-retries.md) to tune them. {% endhint %} Floppy is normally self-hosted. It has no fixed synchronization schedule requirement. Very frequent runs can still add unnecessary load. ### What it supports * Direction: source or target in a pair, one-way or two-way * Features: * **Watchlist** (movies and shows) * **Ratings** (movies and shows) * **History** (watched movies and episodes) * **Progress** (movies and episodes) * **Playlists** (not supported) * Delta sync: not supported. CW reads current Floppy state through paginated API requests. * IDs: TMDb IDs are required. Episodes also require the show TMDb ID, season number, and episode number. {% hint style="warning" %} The Floppy adapter is experimental. {% endhint %} ### Watchlist behavior * **Read:** reads movies and shows from the configured Floppy list. * **Write:** adds or removes movies and shows. * Default list name: `Watchlist`. * CW finds the configured list by name. * If the list is missing, CW creates it when adding an item. * Items without a TMDb ID cannot synchronize. The watchlist uses a standard Floppy custom list. It does not enable CW playlist synchronization. ### Ratings behavior * **Read:** reads ratings from tracked Floppy movies and shows. * **Write:** upserts or removes ratings. * Rating scale: `0–10`. * Values above `10`, through `100`, are converted to the `0–10` scale. * CW can create the media entry before applying a rating. * A rating of zero clears the rating. Season and episode ratings are not supported. ### History behavior * **Read:** reads completed movies and watched episodes. * **Write:** marks movies or episodes as watched. * **Remove:** removes movie or episode watched state. * Movie history uses the movie TMDb ID. * Episode history uses the show TMDb ID, season number, and episode number. Show-level and season-level history are not supported. Movie writes mark the item completed. Episode writes create a watch event when needed. ### Progress behavior * **Read:** reads movie and episode resume positions. * **Write:** synchronizes movie and episode resume positions. * Progress requires a usable movie or episode identity. Show-level and season-level progress are not supported. ### Pagination CW reads Floppy results in pages of up to `200` items. Each request sequence has an internal limit of `1000` pages. This is a CW safety boundary. It is not a confirmed Floppy account or storage limit. ### Settings (advanced) #### Server URL Example: `http://floppy:8000` The server must be reachable from the CW container or host. #### API token Create the token in Floppy under **Settings → Advanced**. #### Verify SSL Default: disabled Enable this when Floppy uses HTTPS with a certificate that needs validation. #### Timeout Default: `12` seconds #### Watchlist name Default: `Watchlist` Controls the Floppy custom list used for watchlist synchronization. #### GET rate Default: `20` requests per second #### POST rate Default: `20` requests per second ### Limitations * **Experimental:** Floppy is new and its API can still change. * Sync speed depends on where and how you run Floppy. Large imports can take time. * Large history backfills can be slow. Floppy handles watched records one item at a time. * Watchlist supports movies and shows only. * Ratings support movies and shows only. Season and episode ratings are not. * History supports movies and individual episodes only. * Progress supports movies and individual episodes only. * TMDb matching is required. Items without a TMDb ID remain unresolved. --- # 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/floppy.md?ask=&goal= ``` `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.