Profiles

Profiles let you use multiple accounts or servers for one provider (media servers, trackers, others)

Start with the built-in default profile.

Add another profile only when you need another account or server.

For most users

Use the default profile for each provider.

Set up a provider in Settings → Connections.

Choose the profile on each sync pair or Watcher route.

You do not need profile IDs or configuration files.

When to add a profile

Add a profile when one provider needs separate connections.

Common examples:

A Plex server at home and another remotely.
A Trakt account for you and another for a partner.
Jellyfin servers for separate libraries or households.

Set up profiles in the UI

1. Add the connection

Each profile stores its own connection details in Settings → Connections.

Select Profile to create another connection.

Set its credentials, server URL, user, and provider options.

2. Select profiles for sync pairs

Each side of a pair can use its own profile.

3. Select profiles for Watcher routes

Choose a profile for both the provider and the sink.

Profiles are independent.

Set each profile's required token, URL, and provider options.

Pairs and Watcher routes can reference profiles directly.

Before deleting a profile, update each pair or route using it.

Otherwise runs can fail or use the wrong account or server.

This section covers profile IDs, config.json, and API fields.

Profile IDs

default is reserved.
Extra profiles use PROVIDER-P##.
Examples: PLEX-P01, TRAKT-P01, SIMKL-P02.

The Profile button always creates the next free ID.

If PLEX-P01 already exists, the next profile is PLEX-P02.

Config and API field names

Use these fields when you edit config.json or call the API.

Each provider can define extra profiles in an instances map.

{
  "plex": {
    "account_token": "...",
    "server_url": "http://plex.local:32400",
    "instances": {
      "PLEX-P01": {
        "account_token": "...",
        "server_url": "https://remote-plex.example"
      }
    }
  }
}

Pairs use:

source_instance
target_instance

Both default to default.

{
  "pairs": [
    {
      "enabled": true,
      "source": "PLEX",
      "source_instance": "PLEX-P01",
      "target": "TRAKT",
      "target_instance": "TRAKT-P01",
      "mode": "one-way",
      "features": { "watchlist": true, "ratings": false, "history": true, "playlists": false }
    }
  ]
}

Watcher routes use provider_instance and sink_instance.

Each route is:

provider(profile) → sink(profile)

{
  "scrobble": {
    "watch": {
      "routes": [
        {
          "id": "R1",
          "enabled": true,
          "provider": "plex",
          "provider_instance": "default",
          "sink": "trakt",
          "sink_instance": "TRAKT-P01",
          "filters": {}
        }
      ]
    }
  }
}

Connect providers: Authentication
Configure sync pairs: Configure Pairs
Configure real-time scrobbling: Watcher
Scope media-server libraries per profile: Library Whitelisting

PreviousAnime ID Mapping NextLibrary Whitelisting

Last updated 5 days ago

Was this helpful?