From b4e39be46b1e509be028571bda7a0d92f19d0c72 Mon Sep 17 00:00:00 2001 From: Baptiste Roux Date: Sat, 19 Feb 2022 14:22:01 +0100 Subject: [PATCH] Install pip modules using requirements.txt; Switch to 'python -m pip' to use the correct version of pip --- README.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 94bbc59..3bd20d3 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,23 @@ # TV Time to Trakt - Import Script + ![](https://loch.digital/image_for_external_apps/4342799-01.png) 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](https://www.datarequests.org/blog/sample-letter-gdpr-access-request/) into an email @@ -21,6 +26,7 @@ TV Time's API is not open. In order to get access to your personal data, you wil 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"](https://trakt.tv/oauth/applications) 3. Select "New Application" @@ -30,11 +36,17 @@ TV Time's API is not open. In order to get access to your personal data, you wil 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` + +``` +python -m pip install -r requirements.txt +``` + ### 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). ``` @@ -49,4 +61,5 @@ Create a new file named `config.json` in the same directory of `TimeToTrakt.py`, 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 \ No newline at end of file + +City vector created by freepik - www.freepik.com