Skip to content
master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.

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. See CONTRIBUTING.md for more details.
  • If you have a feature request, or need help with something, head over to the Discussions forum.
  • Proper PRs are welcome.

Acknowledgements