SinTan1729/TvTimeToTrakt
1
0
Fork 0
mirror of https://github.com/SinTan1729/TvTimeToTrakt.git synced 2024-12-25 04:48:38 -06:00
Code Issues Projects Releases Packages Wiki Activity
A Python script to import TV Time data into Trakt.TV
16 commits 1 branch 0 tags 138 KiB
Python 100%
Find a file
Baptiste Roux 9436798e47
Change field selection to named columns instead of indexes. (csv.DictReader) 
Allow empty menu input, defaulting to choice #1
Change total line count to reuse already opened CSV file
Use enumerate() to track row ID
2022-02-19 11:58:40 +01:00
.vscode removing previous commits to protect private data 2021-04-09 15:13:06 +01:00
.gitignore updated index numbers of seen_episode 2021-11-22 20:40:26 +00:00
README.md refactoring, and improved comments 2021-04-09 22:05:46 +01:00
requirements.txt Add requirements file 2022-02-19 11:58:27 +01:00
TimeToTrackt.py Change field selection to named columns instead of indexes. (csv.DictReader) 2022-02-19 11:58:40 +01:00

README.md

TV Time to Trakt - Import Script

A Python script to import TV Time tracked episode data into Trakt.TV - using data export provided by TV Time through a GDPR request.

Issues

They'll be a few! This was quickly put together within a few hours or so for personal usage. If you come across anything then let me know in the 'Issue' section, and I'll provide support where possible.

Notes

  1. 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.
  2. A delay of 5 seconds is added between each episode to ensure fair use of Trakt's API server. You should adjust this for your own import, but make sure it's at least 1 second to remain within the rate limit.
  3. Episodes which have been processed will be saved to a TinyDB file localStorage.json - when you restart the script, the program will skip those episodes which have been marked 'imported'.

Setup

Get your Data

TV Time's API is not open. In order to get access to your personal data, you will have to request it from TV Time's support via a GDPR request - or maybe just ask for it, whatever works, it's your data.

  1. Copy the template provided by www.datarequests.org into an email
  2. Send it to support@tvtime.com
  3. Wait a few working days for their team to process your request
  4. Extract the data somewhere safe on your local system

Register API Access at Trakt

  1. Go to "Settings" under your profile
  2. Select "Your API Applications"
  3. Select "New Application"
  4. Provide a name into "Name" e.g John Smith Import from TV Time
  5. Paste "urn:ietf:wg:oauth:2.0:oob" into "Redirect uri:"
  6. Click "Save App"
  7. Make note of your details to be used later.

Setup Script

Install Required Libraries

Install the following frameworks via Pip:

  1. pip install trakt
  2. pip install tinydb

Setup Configuration

Create a new file named config.json in the same directory of TimeToTrakt.py, using the below JSON contents (replace the 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"
}

Once the config is in place, execute the program using python TimeToTrakt.py. The process isn't 100% automated - you will need to pop back, especially with large imports, to check if the script requires a manual user input.

Credit

City vector created by freepik - www.freepik.com