To apply different sync rules to different libraries (e.g., sync ratings for Movies but not for TV Shows), you should define multiple server entries in servers.yml. Each entry represents a unique configuration setup. When running the sync, you must specify which configuration to use with the --server flag.

# servers.yml example: Multiple server entries for different library behaviors
servers:
  Example1:
    token: ~
    urls:
      - http://localhost:32400
    config:
      libraries:
        - "Movies"
      sync:
        plex_to_trakt:
          ratings: true
          watched_status: true
        trakt_to_plex:
          ratings: true
          watched_status: true
  Example2:
    token: ~
    urls:
      - http://localhost:32400
    config:
      libraries:
        - "TV Shows"
      sync:
        plex_to_trakt:
          ratings: true
          watched_status: false
        trakt_to_plex:
          ratings: true
          watched_status: false

To run:

plextraktsync --server Example1 sync

plextraktsync --server Example2 sync

To run the watch command as a background daemon on Linux, you can use systemd.

System-wide Service

Create a unit file (e.g., /etc/systemd/system/PlexTraktSync.service):

[Unit]
Description=PlexTraktSync watch daemon
After=network-online.target

[Service]
ExecStart=plextraktsync watch
Restart=on-failure
RestartSec=10
User=user
Group=user

[Install]
WantedBy=multi-user.target

Then run: sudo systemctl daemon-reload
sudo systemctl start PlexTraktSync.service
sudo systemctl enable PlexTraktSync.service

User-level Service (Template)

This allows running different services for different Plex servers using the servers.yml names. Place the file in ~/.config/systemd/user/plextraktsync@.service:

[Unit]
Description=PlexTraktSync watch daemon
After=network-online.target

[Service]
ExecSearchPath=%h/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
ExecStart=plextraktsync watch --server=%i
Restart=on-failure
RestartSec=10

[Install]
WantedBy=default.target

To manage instances (where SERVER_NAME is from servers.yml):

1. systemctl --user daemon-reload
2. systemctl --user start "plextraktsync@SERVER_NAME.service"
3. systemctl --user enable "plextraktsync@SERVER_NAME.service"

Note: To allow the service to run without an active login session, enable lingering with loginctl enable-linger.

If you are using Docker, you can automate sync jobs using the ofelia scheduler. In your docker-compose.yml, you can define jobs that run the sync command for specific servers.

Important: If you are running only one plextraktsync container, ensure your scheduled jobs do not overlap. Ofelia will skip a scheduled run if the previous job is still active. If you have multiple containers, they can run simultaneously.

services:
  plextraktsync:
    image: ghcr.io/taxel/plextraktsync
    command: sync
    container_name: plextraktsync
    volumes:
      - ./config:/app/config
    environment:
      - PUID=1000
      - PGID=1000
    depends_on:
      - plex
  scheduler:
    image: mcuadros/ofelia:0.3
    container_name: scheduler
    command: daemon --docker
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    labels:
      ofelia.job-run.plextraktsync.schedule: "0 6,18 * * *"
      ofelia.job-run.plextraktsync.container: "plextraktsync"
      ofelia.job-run.plextraktsync.command: "--server 'Example1' sync"
      ofelia.job-run.plextraktsync2.schedule: "0 12,0 * * *"
      ofelia.job-run.plextraktsync2.container: "plextraktsync"
      ofelia.job-run.plextraktsync2.command: "--server 'Example2' sync"

By default, all libraries are processed. You can control which libraries are synced using excluded-libraries or libraries keys in your configuration files.

Global Exclusion

In config.yml, use excluded-libraries to list names of libraries you want to skip.

Per-Server Exclusion/Inclusion

In servers.yml, you can define library settings for specific servers.

• Use excluded-libraries to skip specific libraries for that server.
• Use libraries to specify only the libraries to be processed. If you use libraries, the global excluded-libraries setting is ignored for that server.

# servers.yml example: Excluding a library
servers:
  Example1:
    token: ~
    urls:
      - http://localhost:32400
    config:
      excluded-libraries:
        - "Family Movies"

# servers.yml example: Including only specific libraries
servers:
  Example1:
    token: ~
    urls:
      - http://localhost:32400
    config:
      libraries:
        - "Movies"
        - "TV Shows"