Skip to content

Installation

Jump to bottom
Krut Patel edited this page Jan 17, 2021 · 15 revisions

Linux/Mac/Windows Installation Steps

  1. Open a terminal/powershell.
  2. Ensure you have Python 3.7 or higher installed, and in your system PATH. (Check by running python --version)
  3. Ensure pip is installed. (Check: pip --version)
  4. Install pipx:
    MacOS: 
    brew install pipx
pipx ensurepath
    Linux and windows (replace python3 with python if the commands fail): 
    python3 -m pip install --user pipx
python3 -m pipx ensurepath
    (Windows users may require a reboot after this step)
  5. Run pipx install trakt-scrobbler. You will now have the trakts command available. Check out Variations section for extra modifications to the installation.
  6. Run trakts init. You will be prompted to select the players to be monitored, and authorize the app to access the Trakt.tv API on your behalf. Follow the steps on screen to finish the process.

Next Steps

  1. Players Setup
  2. Read FAQ
  3. How to use the trakts command

Updating

The scrobbler keeps getting updated with bug fixes and new features. Make sure to regularly (once a month should be enough) run the update command: pipx upgrade trakt-scrobbler to fetch the latest changes.

Variations

In the following commands, replace install with install --force if you have already installed the scrobbler.

Installing other versions

To install a beta (non-stable) version: pipx install --pip-args="--pre" trakt-scrobbler

To install an unreleased version, directly from the master branch: pipx install git+https://github.com/iamkroot/trakt-scrobbler.git@master

SOCKS Proxy support

In step 5, use pipx install "trakt-scrobbler[socks]". See Configuration Reference section to see how to set up the proxy.

Notification support in Linux

  • For normal notifications, use libnotify. Nothing fancy, simple installation.
    • Arch/Manjaro: pacman -S libnotify
    • Ubuntu: apt install libnotify-bin
  • For updatable notifications, use pygobject. This allows a later notifications to replace a previous one, useful when multiple actions are done is a short span of time. Installation can be painful, and increases the dependencies a lot.
    1. Install your distribution's package for pygobject
    2. Run pipx install "trakt-scrobbler[linux_gobject]".
Clone this wiki locally