Skip to content

Installation macOS (Terminal)

af1 edited this page Mar 1, 2024 · 3 revisions

Table of Contents:

Installation

Install: Unsupported AppStore (v2)

  1. Download the latest release of the WebTools plugin from here

  2. Extract the downloaded ZIP archive

    unzip WebTools.bundle.zip
  3. Copy the WebTools.bundle folder to the Plug-ins folder on your system:

    cp -r WebTools.bundle ~/Library/Application\ Support/Plex\ Media\ Server/Plug-ins/
  4. Restart Plex Media Server

  5. Open the WebTools interface at http://<System IP>:33400 or http://<System IP>:33443 and login with your Plex.tv account

  6. Open the "Unsupported AppStore" module:

  7. Find the "Trakt.tv" plugin listed under "Application", and click "Install":

  8. The "Trakt.tv" plugin should appear at Settings > Manage > Plugins in about one minute. (but can vary depending on the speed of your system)

    If the plugin doesn't appear after waiting a few minutes: the plugin may not be installed correctly, or has crashed on startup. Please post an issue here with the latest plugin log file for support.

  9. Configure the plugin by clicking on the plugin settings button at Settings > Manage > Plugins:

Install: Manual

  1. Download the latest release of the Trakt.tv plugin

    • Stable (recommended)

      curl "https://github.com/trakt/Plex-Trakt-Scrobbler/archive/master.zip" -Lo Plex-Trakt-Scrobbler.zip
    • Beta

      curl "https://github.com/trakt/Plex-Trakt-Scrobbler/archive/beta.zip" -Lo Plex-Trakt-Scrobbler.zip
    • Development

      curl "https://github.com/trakt/Plex-Trakt-Scrobbler/archive/develop.zip" -Lo Plex-Trakt-Scrobbler.zip
  2. Extract the downloaded ZIP archive

    unzip Plex-Trakt-Scrobbler.zip
  3. Copy the Trakttv.bundle folder to the Plug-ins folder on your system:

    sudo cp -r Plex-Trakt-Scrobbler-*/Trakttv.bundle ~/Library/Application\ Support/Plex\ Media\ Server/Plug-ins/
  4. Restart Plex Media Server

  5. The "Trakt.tv" plugin should appear at Settings > Manage > Plugins in about one minute. (but can vary depending on the speed of your system)

    If the plugin doesn't appear after waiting a few minutes: the plugin may not be installed correctly, or has crashed on startup. Please post an issue here with the latest plugin log file for support.

  6. Configure the plugin by clicking on the plugin settings button at Settings > Manage > Plugins:

Fixes

Fix: Permissions

Copying the plugin into the Plug-ins folder may result in incorrect permissions on the Trakttv.bundle folder, permissions can be fixed with the following steps:

  1. Determine the user + group which has ownership of Plex Media Server:

    stat -f '%u:%g' ~/Library/Application\ Support/Plex\ Media\ Server
  2. Update ownership of the Trakttv.bundle folder

    sudo chown -R <uid>:<gid> ~/Library/Application\ Support/Plex\ Media\ Server/Plug-ins/Trakttv.bundle

    (Replace <uid>:<gid> with the output from step 1)

  3. Update permissions on the Trakttv.bundle folder

    sudo chmod -R 770 ~/Library/Application\ Support/Plex\ Media\ Server/Plug-ins/Trakttv.bundle