TimeToTrakt

A quick Python script to import TV Time watched episode data into Trakt.TV - using data provided by Whip Media Company via a GDPR request.

Issues

They'll be a few! If you come across anything then let me know in the 'Issue' section, and I'll provide help where possible.

Notes

The script is using limited data provided from a GDPR request - so the accuracy isn't 100%. But you will be prompted to manually pick the Trakt show, when it can't be determined automatically.
A delay of 5 seconds is added between each episode to ensure fair use of Trakt's servers - especially with my import of 6,500 episodes.
Episodes which have been imported are be saved to localStorage.json - this will let you re-run and skip to episodes which have not been imported yet.

Setup

Get your Data

The TV Time API is request based only. In order to get access to your data, you will have to request it from TV Time's Support via a GDPR request - or just ask for it!

Copy the template provided by www.datarequests.org into an email.
Send it to support@tvtime.com
Wait a few working days to process the request
Extract the data somewhere safe.

Register API Access at Trakt

Go to "Settings" under your profile
Select "Your API Applications"
Select "New Application"
Provide a random name into "Name"
Paste "urn:ietf:wg:oauth:2.0:oob" into "Redirect uri:"
Click "Save App"
Make note of your app

Setup Script

Install Required Libraries

Install the following frameworks via Pip:

trakt
tinydb

Setup Configuration

Create a new file named config.json, with the below JSON (replace values with your own).

{
    "CLIENT_ID": "YOUR_CLIENT_ID",
    "CLIENT_SECRET": "YOUR_CLIENT_SECRET",
    "GDPR_WORKSPACE_PATH": "DIRECTORY_OF_YOUR_GDPR_REQUEST_DATA",
    "TRAKT_USERNAME": "YOUR_TRAKT_USERNAME"
}

Then, execute the program using the ./python3 TimeToTrakt.py - make sure to pop back and confirm selection of shows when prompted.

2.1 KiB Raw Blame History