• Trakt.tv tools
  • Purpose
  • Requirements
    • On Docker
    • On Ubuntu/Debian Linux system
    • On Arch/Manjaro Linux system
    • On Windows system
    • On macOS system
  • Usage
  • Configuration
    • Configuration sample
    • Configuration details
  • Developer documentation
  • Howto
    • Import
    • Export
    • Sync
    • Export data from Kodi
    • Export data from CouchPotato
  • Support
  • Contribution
  • Licence

• Import Movies or TVShows IDs from CSV file format into Trakt.tv.
• Import Ratings of Movies or TVShows IDs from CSV file format into Trakt.tv.
• Export Movies or TVShows IDs from Trakt.tv list into CSV file format.
• Create trakt.tv custom list from TDMB discover with filter.

You must use Python 3.x.

To run Docker hub image

$ docker pull xbgmsharp/docker-trakt-tools
$ docker run -it --rm --name my-trakt-tools xbgmsharp/docker-trakt-tools python export_trakt.py -v
export_trakt.py 0.3

You might need to use the --privileged options on some case/

$ docker run --privileged -it --rm --name my-trakt-tools xbgmsharp/docker-trakt-tools python export_trakt.py -v
export_trakt.py 0.3

Create and edit default config

$ docker run -it --rm \
  --name my-trakt-tools \
  -v $(pwd):/trakt/export \
  -v $(pwd):/trakt/config \
  xbgmsharp/docker-trakt-tools \
  python export_trakt.py -c config/config.ini

Run export

$ docker run -it --rm \
  --name my-trakt-tools \
  -v $(pwd):/trakt/export \
  -v $(pwd):/trakt/config \
  xbgmsharp/docker-trakt-tools \
  python export_trakt.py -c config/config.ini -o export/export_movies_history.csv

my-trakt-tools is the container name.

xbgmsharp/docker-trakt-tools is the image name.

To build the image

$ docker build -t xbgmsharp/docker-trakt-tools .

To build the multi-arch image

$ ./multi-arch-docker-ci.sh

Ensure you are running Python 3

$ python -V
Python 3.5

Install need module dependencies, python3-openssl and jq are optional

$ apt-get install python3-dateutil python3-simplejson python3-requests python3-openssl jq

Install dependencies with pacman, python-pyopenssl and jq are optional

$ pacman -S python python-dateutil python-simplejson python-requests python-pyopenssl jq 

Download the installer: https://www.python.org/downloads/windows/

Ensure you are running Python 3

<python dir>>python.exe -V
Python 3.5

Install need module dependencies

<python dir>\Scripts\pip3.exe install requests simplejson

Download the installer: https://www.python.org/downloads/mac-osx/

Append to PATH in ZSH

$ path=('/Library/Frameworks/Python.framework/Versions/3.8/bin' $path)

Ensure you are running Python 3

$ python3 -V
Python 3.8.5

Run Install Certificates.command

$ pip3 install certifi

Open a new Terminal session so that certificates will be available

Install need module dependencies, pyopenssl and jq are optional

$ pip3 install python-dateutil
$ pip3 install simplejson
$ pip3 install requests
$ pip3 install pyopenssl
$ pip3 install jq

• Create an Trakt.tv application to have your own client_id and client_secret, https://trakt.tv/oauth/applications. You only need to fill up the Name with a Description and Redirect uri to urn:ietf:wg:oauth:2.0:oob, leave the rest empty and click on SAVE APP.

• Run the script to create a default config file config.ini

$ python export_trakt.py

• Edit the config file config.ini and specify the client_id and client_secret as well as any other settings appropriate to your enviromenent, eg: URL, proxy, etc... Refer to Configuration details section for more information.

$ vim config.ini

• Run the script to authenticate against Trakt.tv API using the PIN method and it will generate an access_token and refresh_token. You will be prompted to open a link into a browser and paste the pincode back to the script. The generated access_token and refresh_token are automaticaly saved into the config file config.ini.

$ python export_trakt.py

[TRAKT]
client_id = xxxxxxxxxxxxxxxxxxxxxxxxx
client_secret = xxxxxxxxxxxxxxxxxxxxxx
access_token =
refresh_token =
baseurl = https://api-v2launch.trakt.tv
[SETTINGS]
proxy = False
proxy_host = https://127.0.0.1
proxy_port = 3128

• client_id: Uniq ID to identify your application, https://trakt.tv/oauth/applications
• client_secret: Uniq ID to identify your application, https://trakt.tv/oauth/applications
• access_token: Uniq ID to identify yourself against your application, manage by the script
• refresh_token: Uniq ID to identify yourself against your application, manage by the script
• baseurl: API base URL, depends on the platfrom, eg: Production (https://api-v2launch.trakt.tv) or Staging (https://api-staging.trakt.tv)
• proxy: True/False setting to enable proxy support
• proxy_host: Full URI of the proxy
• proxy_port: Port of the proxy to connect to

$ pydoc `pwd`/import_trakt.py
$ pydoc `pwd`/export_trakt.py
$ pydoc `pwd`/sync_tmdb_trakt.py

Import CSV into trakt.tv

Export data from trakt.tv into CSV

Create trakt.tv list from TDMB discover with filter

Export Movies or TVShows IDs from Kodi into CSV file format. Export data from Kodi

Export Movies IDs from CouchPotato into CSV file format. Export data from CouchPotato

To get support, please create new issue

I'm happy to accept Pull Requests!

This script is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

See http://www.gnu.org/licenses/gpl.html.