movie and TV show scrobbler for Kodi
Latest commit 2e21f57 Jan 17, 2017 @Razzeee Razzeee committed on GitHub Update addon.xml
Failed to load latest commit information.
resources Use kryptons assets Oct 30, 2016
tests Streamlined setting as watched and fixed a display bug Oct 30, 2016
.gitignore Update gitignore Mar 14, 2016
.gitlab-ci.yml Added gitlab test runner config Apr 7, 2016
.travis.yml Update .travis.yml May 8, 2016
LICENSE.txt initial BETA, scrobbling should work properly Jul 20, 2012 Update Mar 10, 2016
addon.xml Update addon.xml Jan 17, 2017
changelog.txt Update changelog.txt Oct 20, 2016 pep8 cleanup Mar 22, 2015 Finish device auth implementation Apr 18, 2016 Migrate to a class based traktAPI usage Mar 11, 2013 Fix case where encoding gets fooled when comparing with excluded paths Oct 20, 2016 Split utilities class Mar 10, 2016 Remove close window after playback (fingers crossed - not sure what's… Aug 18, 2016 Fixed bug when trying to start authentication manually Apr 28, 2016 Secondary Title Lookup Feature May 27, 2016 Streamlined setting as watched and fixed a display bug Oct 30, 2016 Removed unused imports Apr 13, 2015 Split utilities class Mar 10, 2016 Fixed wrong return Apr 4, 2016 More refactoring, more tests, better code Mar 27, 2016 Fixed some overlooked calls Mar 10, 2016 Handle auth errors, when trakt is down or the network is not working. Nov 1, 2016 Merge branch 'master' into master Jan 17, 2017

Codacy Badge Build Status scrobbler and library sync

Table of Contents

What is Trakt?

Automatically scrobble all TV episodes and movies you are watching to! 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 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 and you should use TVDb (for tv shows) and TMDb (for movies) as your scrapers. TV shows are identified using their TVDb ID. Movies are identified using the IMDb ID. This allows Trakt to match the correct show or movie more accurately, regardless of the title.

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.


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:

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


  1. Clone this repository (or download it here) into a folder called script.trakt inside your Kodi addons folder
  2. Start Kodi (or restart if its already running)
  3. 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)
  4. Navigate to Settings > Add-ons > Enabled add-ons > Services > Trakt
  5. Select Trakt and go to Configure
  6. Get your PIN here and enter it, change any other settings as needed
  7. Select OK to save your settings
  8. Watch something and see it show up on!

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's-to-facilitate-scrobbling


"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.


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 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.


  • 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