Floppy

Floppy adapter notes for syncing watchlist, ratings, history, and progress.

Floppy adapter lets CW synchronize with a Floppy server. It supports watchlist, ratings, history, and progress.

Connect Floppy first. Use Floppy (Authentication provider).

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 to tune them.

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.

The Floppy adapter is experimental. This means only use it in one-way pairs

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.