5. Lists

Lists (Overview)

Yamtrack lists are flexible collections that can mix media types. Lists are separate from tracking (status/history), so they're ideal for curating watch/read/play queues, recommendations, or thematic groupings.

Creating lists + visibility

• Create lists from the Lists page and set a name, description, collaborators, and visibility.
• Public lists are viewable by anyone with the link; Private lists are restricted to you and collaborators.
• Collaborators can edit lists and add/remove items; only the owner can delete a list.
• The Allow recommendations toggle only applies to public lists; private lists cannot accept recommendations.

Adding items to lists

• Use the Lists button on media cards or detail pages to add/remove items.
• Lists can contain multiple media types in the same list.
• List detail pages support search, type filters, and sorting for large lists.

List activity (what gets logged)

• List created and list edited events.
• Items added or removed.
• Recommendations approved or denied.
• Activity history is visible to list owners/collaborators (top 100 events).

Recommendations workflow

• Public lists can enable recommendations, which unlocks a Recommend Item flow.
• Anyone with the link can recommend items; logged-in users are attributed, anonymous users can add a name and note.
• Owners/collaborators review recommendations and approve (adds to list) or deny (removes the recommendation).
• Approval/denial actions are recorded in list activity.

Trakt list imports

• Trakt list import is available from the Lists page and uses a separate Trakt OAuth (client ID + secret).
• Importing rebuilds Trakt-sourced lists each time (existing Trakt lists are deleted and recreated).
• Imports your Trakt lists and watchlist into Custom Lists (Movies/Shows only, via TMDB IDs).
• The watchlist is imported as a private list named Watchlist.
• Items without a TMDB mapping are skipped.

Public Lists: RSS and JSON Exports

Public lists expose read-only feeds for sharing and automation.

Public list behavior

• Public list detail pages are viewable without login.
• Your public profile page at /user/<username> shows all public lists.
• Public views use the base_public.html template.

RSS feed

• URL: /list/<id>/rss
• Public lists only (private lists return 404).
• Each item uses its title, media type + source, item link, and date added.

JSON exports (Radarr / Sonarr)

• URL: /list/<id>/json?arr=radarr or /list/<id>/json?arr=sonarr
• Public lists only; missing/invalid arr returns 400.
• Radarr: returns TMDB movie IDs: { "id": <tmdb_id> }.
• Sonarr: returns TVDB IDs mapped from TMDB: { "tvdbId": <tvdb_id> }.
• Items without a TVDB mapping are skipped in the Sonarr export.

Troubleshooting

• Public list returns 404: the list is private or the ID no longer exists.
• Login redirect: you opened a collaborator-only view (recommendations/activity) instead of the public list.
• Empty Sonarr export: the list has no TMDB TV shows with TVDB mappings.
• Empty Radarr export: the list has no TMDB movies.