Trakt.tv scrobbler and library sync

What is Trakt?
What can this addon do?
What can be scrobbled??
Installation
Problems?
Contribute
- Pull requests
- Translations
Thanks

What is Trakt?

Automatically scrobble all TV episodes and movies you are watching to Trakt.tv! Keep a comprehensive history of everything you've watched and be part of a global community of TV and movie enthusiasts. Sign up for a free account at Trakt.tv and get a ton of features:

Automatically scrobble what you're watching
Mobile apps for iPhone, iPad, Android, and Windows Phone
Share what you're watching (in real time) and rating to facebook and twitter
Personalized calendar so you never miss a TV show
Follow your friends and people you're interesed in
Use watchlists so you don't forget what to watch
Track your media collections and impress your friends
Create custom lists around any topics you choose
Easily track your TV show progress across all seasons and episodes
Track your progress against industry lists such as the IMDb Top 250
Discover new shows and movies based on your viewing habits
Widgets for your forum signature

What can this addon do?

Automatically scrobble TV episodes and movies you are watching
Sync your TV episode and movie collections to Trakt (manually or triggered by a library update)
Keep watched statuses synced between Kodi and Trakt
Rate movies and episodes after watching them
Custom skin/keymap actions for toggling watched status, and rating (tagging and listing disabled for now)

What can be scrobbled?

This plugin will scrobble local media and most remote streaming content. Local media should be played in Kodi library mode. Trakt will attempt to identify the media through different third party IDs available from the metadata. TV shows are identified by TVDb ID or IMDb ID. Movies are identified by TMDb ID or IMDb ID. This allows Trakt to match the correct show or movie more accurately, regardless of the title. The best supported and recommended configuration is to use TVDb (for tv shows) and TMDb (for movies) as your scrapers.

Remote streaming content will scrobble assuming the metadata is correctly set in Kodi. Add-ons that stream content need to correctly identify TV episodes and movies with as much metadata as possible for Trakt to know what you're watching.

Installation

If your not a developer, you should only install this from the official Kodi repo via Kodi itself. If you are a dev, here is how you install the dev version:

Download the zip (download it here)
Install script.trakt by zip. Go to Settings > Add-ons > Install from zip file > Choose the just downloaded zip
Navigate to Settings > Add-ons > Enabled add-ons > Services > Trakt
Select Trakt and go to Configure
Get your PIN here and enter it, change any other settings as needed
Select OK to save your settings
Watch something and see it show up on Trakt.tv!

Clone this repository (or download it here) into a folder called script.trakt inside your Kodi addons folder
Start Kodi (or restart if its already running)
Make sure you have the modules Trakt and dateutil installed. Check under Settings > Add-ons > Get Add-ons > All Add-ons > Add-on libraries (restart if you had to install these)
Navigate to Settings > Add-ons > Enabled add-ons > Services > Trakt
Select Trakt and go to Configure
Get your PIN here and enter it, change any other settings as needed
Select OK to save your settings
Watch something and see it show up on Trakt.tv!

Please note that something does not cover all Kodi possible streaming sources. Local files and strm files scrapped to your library should be OK, however generic third party streaming addons can fail. It is up to the developers of these addons to be supported by this plugin. Please take a look https://github.com/trakt/script.trakt/wiki/Providing-id's-to-facilitate-scrobbling

Problems?

"I found something that doesn't work"

Search the issues on github to see if it has already been reported, if so add your information there.
If not, create a new issue and provide as much data about your system as possible, a logfile will also be needed.

Creating logfiles

To create a logfile, enable the debug setting in Kodi AND script.trakt, otherwise the logfile won't show any data from script.trakt. Check the Kodi documentation if you don't know where your logfile can be found.

Invoke sync via jsonrpc

Save this as kodi-trakt-update.sh

#!/bin/sh

# url to kodi jsonrpc
url=http://localhost:8080/jsonrpc

# https://github.com/trakt/script.trakt/issues/192#issuecomment-70359374
request='{
        "jsonrpc":"2.0",
        "method":"Addons.ExecuteAddon",
        "params":{
                "addonid":"script.trakt",
                "params":{
                        "action":"sync",
                        "silent":"False"
                }
        },
        "id":1
}'

exec curl -sSLf --include --header 'content-type: application/json;' --request POST --data-binary "$request" "$url"

Contribute

Pull requests

Please don't add pull requests for translation updates these have to go work their way through the translation workflow (see Translations)

Translations

Translations are done via the Transifex project of Kodi. If you want to support translation efforts, read this and look for script-trakt under the XBMC Addons project in Transifex.

Thanks

Special thanks to all who contribute to this plugin! Check the commit history and changelog to see these talented developers.
Special thanks to fuzeman for trakt.py.

fatshotty/script.trakt