FlickList

Connect FlickList to sync watch activity, playlists, and scrobbles.

End users

FlickList tracks movies, shows, and episodes. CW syncs watchlists, ratings, history, progress, and playlists. It can also scrobble to FlickList.

FlickList does not support Collection sync.

Use Device Code for new connections. You do not need an API key.

Connect FlickList

1. Open Settings → Authentication → FlickList.
2. Leave Device Code selected.
3. Click Connect.
4. CrossWatch shows a link code and opens https://flicklist.tv/link.
5. Sign in to FlickList and approve the code.
6. Return to CrossWatch. It shows Connected with Device Code.

Troubleshooting

• If the FlickList page does not open, allow popups. You can also open https://flicklist.tv/link manually.
• If the code expires, start the Device Code flow again.
• If authentication continues to fail, disconnect FlickList and reconnect.

Power users

Power users

CrossWatch supports Device Code and API Key authentication. Device Code is the recommended default.

Device Code

CrossWatch uses its built-in FlickList client ID. No client configuration is required.

The flow opens https://flicklist.tv/link. CrossWatch stores the returned credentials. It associates the connection with the API user.

Set a custom client ID with CROSSWATCH_FLICKLIST_CLIENT_ID or flicklist.client_id.

API Key

1. Open Settings → Authentication → FlickList.
2. Select API Key.
3. Paste your key and save.
4. CrossWatch validates the key against the FlickList user endpoint.

Minimal configuration:

{
  "flicklist": {
    "auth_method": "api_key",
    "api_key": "YOUR_API_KEY"
  }
}

Config keys

• flicklist.auth_method
• flicklist.api_key
• flicklist.access_token
• flicklist.expires_at
• flicklist.username
• flicklist.user_id
• flicklist.client_id

Additional profiles are stored under flicklist.instances.

Set provider limits with flicklist.rate_limit.get_per_sec and flicklist.rate_limit.post_per_sec. Both default to 0.2 requests per second.