https://github.com/iamkroot/trakt-scrobbler

Scrobbler for trakt.tv that supports VLC, Plex, MPC-HC, and MPV.
https://github.com/iamkroot/trakt-scrobbler

python3 scrobble trakt

Last synced: 5 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/iamkroot/trakt-scrobbler
• Owner: iamkroot
• License: gpl-2.0
• Created: 2018-07-27T18:21:48.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-04-23T16:38:28.000Z (7 months ago)
• Last Synced: 2024-04-23T18:09:27.011Z (7 months ago)
• Topics: python3, scrobble, trakt
• Language: Python
• Homepage: https://github.com/iamkroot/trakt-scrobbler/wiki
• Size: 689 KB
• Stars: 427
• Watchers: 20
• Forks: 28
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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](https://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](https://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](https://github.com/iamkroot/trakt-scrobbler/wiki/trakts-CLI-Reference) to control the service. Just run `trakts`.

*   Automatic media info extraction using [guessit](https://github.com/guessit-io/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](https://www.videolan.org/vlc/) (via web interface)

    *   [Plex](https://www.plex.tv) (doesn't require Plex Pass)

    *   [MPV](https://mpv.io) (via IPC server)

    *   [MPC-BE](https://sourceforge.net/projects/mpcbe/)/[MPC-HC](https://mpc-hc.org) (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](https://github.com/iamkroot/trakt-scrobbler/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`](CONTRIBUTING.md) for more details. Proper PRs are welcome.

## Acknowledgements

*   Inspired from [TraktForVLC](https://github.com/XaF/TraktForVLC)

*   [mpv-trakt-sync-daemon](https://github.com/stareInTheAir/mpv-trakt-sync-daemon) was a huge help in making the mpv monitor