trakt-scrobbler

Scrobbler for trakt.tv that supports VLC, Plex, MPC-HC, and MPV


Keywords
trakt, scrobbler, python3, scrobble
License
GPL-2.0-only
Install
pip install trakt-scrobbler==1.4.2

Documentation

Trakt Scrobbler

A trakt.tv scrobbler for your computer.

What is Trakt?

Automatically scrobble TV show episodes and movies you are watching to Trakt.tv! It is a website that keeps a history of everything you've watched!

What is trakt-scrobbler?

trakt-scrobbler is an application that runs in the background and monitors your media players for any new activity. When it detects some file being played, it determines the media info (such as name of the movie/show, episode number, etc.) and sends this to trakt.tv servers, so that it can be marked as "Currently Watching" on your profile. No manual intervention required!

Features

  • Full featured command line interface to control the service. Just run trakts.
  • Automatic media info extraction using guessit.
  • Scrobbling is independent of the player(s) where the media is played. Support for new players can thus be easily added.
  • Currently supports:
    • VLC (via web interface)
    • Plex (doesn't require Plex Pass)
    • MPV (via IPC server)
    • MPC-BE/MPC-HC (via web interface).
  • Folder whitelisting: Only media files from subdirectories of these folders are synced with trakt.
  • Optionally, you can receive a quick notification that the media start/pause/stop activity has been scrobbled.
  • For cases when it misidentifies the files, you can specify a regex to manually extract the necessary details.
  • Proxy support: Optionally specify a proxy server to handle all communication with trakt servers!

Getting Started

Head over to the wiki for further details.

Contributing

Feel free to create a new issue in case you find a bug/want to have a feature added. See CONTRIBUTING.md for more details. Proper PRs are welcome.

Acknowledgements