Sonarr

Sofa can export your TV show watchlist as a custom import list that Sonarr polls automatically.

Setup

1. In Sofa, go to Settings → Integrations and click Connect next to Sonarr
2. Copy the generated list URL
3. In Sonarr, go to Settings → Import Lists
4. Click + and select Custom Lists
5. Paste the URL into the List URL field
6. Configure your preferred quality profile and root folder
7. Save

The list URL looks like:

https://sofa.example.com/api/lists/{token}

Sonarr polls the list periodically (default: every 6 hours) and adds any new shows it finds.

Status Filtering

By default, the list exports titles with a watchlist status. You can customize which statuses are included by appending a query parameter:

# Only watchlist items (default)
https://sofa.example.com/api/lists/{token}?status=watchlist

# Watchlist and in-progress items
https://sofa.example.com/api/lists/{token}?status=watchlist,in_progress

# All tracked items
https://sofa.example.com/api/lists/{token}?status=watchlist,in_progress,completed

How It Works

When Sonarr polls the list, Sofa returns all matching TV shows in Sonarr's custom list format with TVDB IDs. Only TV shows are included — movies are filtered out.

If a show in your watchlist doesn't have a TVDB ID cached, Sofa fetches it from TMDB on the fly and caches it for future requests.