Skip to content

Players Setup

Jump to bottom
iamkroot edited this page Nov 1, 2021 · 10 revisions

Enabling monitors

A major feature of this scrobbler is that it is designed in a way that can support multiple media players. To do so, every player has a corresponding "Monitor", which needs to be enabled if you want the app to pick up media events from that player (in addition to the player-specific setup mentioned in later sections).

Player Monitor Name
VLC vlc
Plex plex
MPV mpv
MPC-HC mpc-hc
MPC-BE mpc-be
SMPlayerMPV smplayer@mpv
SyncplayMPV syncplay@mpv

If you missed setting the monitored players option when you ran trakts init, or if you want to switch to another player, you can use the trakts config set command for doing so:

$ trakts config set players.monitored mpv vlc mpc-be
User config updated with "players.monitored = ['mpv', 'vlc', 'mpc-be']"

VLC

Enable monitor: vlc

Enable the Lua Web Interface from advanced options. Don't forget to specify the password in Lua options.

VLC Web Interface

Detailed instructions can be found here.

Plex

Enable monitor: plex

No server side set up is required, as the app uses the existing API. Do note that since this is a polling based approach, it will be inferior to Webhooks. So if you are a premium user of Plex, it is recommended to use that directly. This app is mainly useful for those users who don't need most of the features of Plex Pass.

User Filter

By default, there is no filtering of activity. However, if you have multiple users on plex, scrobbling from all of them can pollute your Trakt history. You can configure the scrobbler to track activity for only a single plex user.

Run: trakts config set players.plex.scrobble_user <USERNAME> (replace <USERNAME> with whatever Plex shows as name of the user in the UI)

Separate Server Machine

If your plex server is different from where the scrobbler is set up, you need to specify that hostname. Run: trakts config set players.plex.ip <HOSTNAME or IP>

Plex Token

If you already have the plex token available and do not want to enter your credentials during trakts init, follow these steps before running init:

  1. Run trakts plex --token
  2. Enter the token after the prompt
  3. Run trakts init

If you simply want to clear the token and re-authenticate with plex, use trakts plex --force.

MPV

Enable monitor: mpv

Enable the JSON IPC via mpv.conf (Recommended if you are using mpv directly).

mpv.conf location

  • Linux/MacOS: ~/.config/mpv/mpv.conf
  • Windows: C:\users\<USERNAME>\AppData\Roaming\mpv\mpv.conf (you can press Win+R and enter %APPDATA% to open the Roaming folder)

Config modification

Add input-ipc-server=<ipc_path> to the top of the mpv.conf file.

  • Linux/MacOS: input-ipc-server=/tmp/mpvsocket
  • Windows: input-ipc-server=\\.\pipe\mpvsocket

IPC Path

For <ipc_path>, the recommended values are:

  • Linux/MacOS: /tmp/mpvsocket
  • Windows: \\.\pipe\mpvsocket

Wrappers

The scrobbler technically supports the any player which wraps over MPV and allows setting input-ipc-server one way or another.

  • The player will usually provide an option to pass additional arguments to MPV, which is where you should add --input-ipc-server=<ipc_path>
  • Note that in this case, the scrobbler won't be able to autodetect the <ipc_path>, so you need to manually set that using trakts config set players.mpv.ipc_path <ipc_path>

In addition, we also support auto-detection of <ipc_path> by reading the config files of the following players (meaning, no need to use trakts config set ... command).

SMPlayer

Enable monitor: smplayer@mpv

Setup steps:

  1. Go to Settings -> Advanced
  2. Open Mplayer/mpv tab
  3. Set Options to --input-ipc-server=<ipc_path> (see IPC Path section for value of <ipc_path>)
  4. Save
  5. Restart scrobbler with trakts start --restart

Syncplay

Enable monitor: syncplay@mpv

Setup steps:

  1. Open syncplay client configuration
  2. Set player to mpv (needless to say, mpv has to be installed first)
  3. Set Player Arguments (if any) to --input-ipc-server=<ipc_path> (see IPC Path section for value of <ipc_path>)
  4. Save configuration
  5. Restart scrobbler with trakts start --restart

MPC-BE/MPC-HC

Enable monitor: mpc-be or mpc-hc

Enable the web interface from Options.

Clone this wiki locally