Skip to main content

This python script syncs user watchlist, ratings and comments for Movies, TV Shows and Episodes both ways between Trakt and IMDB.

Project description

IMDB-Trakt-Syncer

This Python script syncs user watchlist, ratings and comments for Movies, TV Shows and Episodes both ways between Trakt and IMDB. Data already set will not be overwritten. Ratings are synced by default, watchlist and comment/review sync are optional. The user will be prompted to enter their settings and credentials on first run.

The script is compatible with operating systems that support Python (v3.6 or later) and Chromedriver (Windows, Linux, Mac, and ChromeOS). If you're interested in syncing ratings between Trakt, Plex, IMDB, and TMDB, I recommend the following projects: PlexTraktSync, IMDB-Trakt-Syncer, and TMDB-Trakt-Syncer.

Installation Instructions

  1. Install Python (v3.6 or later) and Google Chrome. If these are already installed, you can skip this step. Please note this script does not affect Chrome in anyway, it is simply required in order for chromedriver to work.
  2. Install the script by executing python -m pip install IMDBTraktSyncer in command line.
  3. Login to Trakt and create a new API application named IMDBTraktSyncer. In the "Redirect uri" field, enter urn:ietf:wg:oauth:2.0:oob, then save the application.
  4. Run the script by executing IMDBTraktSyncer in the command line.
  5. Follow the prompts during the first run. You will need to enter your Trakt client ID and client secret from step 3, as well as your IMDB username and password. Please note that these details are saved insecurely as credentials.txt in the same folder as the script. It is recommended to change your IMDB password to something unique beforehand.
  6. Setup is complete. The script will continue running and syncing your ratings. You can monitor its progress in the command line.

Installing the Script:

python -m pip install IMDBTraktSyncer

Run in your operating system's native command line.

Running the Script:

IMDBTraktSyncer

Run in your operating system's native command line.

Updating the Script:

python -m pip install IMDBTraktSyncer --upgrade

Run in your operating system's native command line.

Uninstalling the Script:

python -m pip uninstall IMDBTraktSyncer

Run in your operating system's native command line.

Installing a Specific Version:

python -m pip install IMDBTraktSyncer==VERSION_NUMBER

Replace VERSION_NUMBER with your desired version (e.g. 1.1.6) and run in your operating system's native command line.

Alternative Manual Installation Method (without pip install)

  1. Install Python (v3.6 or later) and Google Chrome. If these are already installed, you can skip this step. Please note this script does not affect Chrome in anyway, it is simply required in order for chromedriver to work.
  2. Download the latest .zip from the releases page and extract it to the desired directory.
  3. Login to Trakt and create a new API application named IMDBTraktSyncer. In the "Redirect uri" field, enter urn:ietf:wg:oauth:2.0:oob, then save the application.
  4. Run IMDBTraktSyncer.py or open the terminal and navigate to the folder where IMDBTraktSyncer.py is located. Run IMDBTraktSyncer.py in the terminal.
  5. Follow the prompts during the first run. You will need to enter your Trakt client ID and client secret from step 3, as well as your IMDB username and password. Please note that these details are saved insecurely as credentials.txt in the same folder as the script. It is recommended to change your IMDB password to something unique beforehand.
  6. Setup is complete. The script will continue running and syncing your ratings. You can monitor its progress in the command line.

For Setting Up Automation See the Following Wiki Pages:

  • Setup Automation for:
  • Python Script to Update all Packages with Pip (Windows, Linux, Mac, ChromeOS, etc.) Link #1

Troubleshooting, Known Issues, Workarounds & Future Outlook

  • If IMDB requires a captcha on login, and you see "Not signed in" appear in the script, the captcha is likely the cause. To fix this, navigate to the IMDB website in your browser (preferably Chrome) from the same computer. If you're already logged in, log out and log back in. It may ask you to fill in a captcha. Complete the captcha and finish logging in. After successfully logging in on your browser, run the script again, and it should work. You may need to repeat this step once or twice if the issue persists. Adding a captcha solver to the script is being considered but not currently implemented. Issue #2
  • If you see an error about having the incorrect version of Chromedriver, uninstall it by running the following command in the command line: python -m pip uninstall chromedriver-py. In your Chrome browser, go to Settings > About Chrome and check the prefix for your version (e.g., 112... or 111). If the prefix matches your Chrome version, navigate to the chromedriver-py releases page and find the latest version that matches the prefix for your Chrome version. Copy the version number you need (e.g 113.0.5672.63), then run the following command in the command line: python -m pip install chromedriver-py==VERSION_NUMBER. Replace VERSION_NUMBER with the version you copied and press enter. This will install the correct version of Chromedriver. Run the script again, and it should work. Issue #16
  • If any of your details change (passwords, logins, API keys, etc.), simply open credentials.txt, modify your details, save it and then run the script again. Alternatively, delete credentials.txt to reset the script and it will prompt you to enter your new details on the next run.
  • Due to IMDB's lack of API and rating import ability, this script uses an unconventional method that mimics using a web browser to set ratings on IMDB. Therefore, there are many points of failure that could arise. The script will be updated as best as possible.

Screenshot

Demo

Sponsorships, Donations, and Custom Projects

If you find my scripts helpful, you can become a sponsor and support my projects! If you need help with a project, open an issue, and I'll do my best to assist you. For other inquiries and custom projects, you can contact me on Twitter.

More Donation Options:

  • Cashapp: $rileyxx
  • Venmo: @rileyxx
  • Bitcoin: bc1qrjevwqv49z8y77len3azqfghxrjmrjvhy5zqau
  • Amazon Wishlist: Link ↗

Also Posted On

License: MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

IMDBTraktSyncer-1.2.7.tar.gz (17.0 kB view details)

Uploaded Source

Built Distribution

IMDBTraktSyncer-1.2.7-py3-none-any.whl (19.4 kB view details)

Uploaded Python 3

File details

Details for the file IMDBTraktSyncer-1.2.7.tar.gz.

File metadata

  • Download URL: IMDBTraktSyncer-1.2.7.tar.gz
  • Upload date:
  • Size: 17.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.1

File hashes

Hashes for IMDBTraktSyncer-1.2.7.tar.gz
Algorithm Hash digest
SHA256 f22c5853a0c3f0f6dc20d63d25655f9c488599cbc3e3f5355a4b9739815b91c9
MD5 1c6a66d6932572508f0650a6b324d4cd
BLAKE2b-256 4673c8b6d0c30ab7dd7ae1283a39348322f18fa99c6e0ad58347c61fc788c636

See more details on using hashes here.

File details

Details for the file IMDBTraktSyncer-1.2.7-py3-none-any.whl.

File metadata

File hashes

Hashes for IMDBTraktSyncer-1.2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 e5b4c8343a1ee8eb2c17bc44951a51096f1750adede41c862457169f271314c0
MD5 855d1999bf665739c74c57310b547724
BLAKE2b-256 02477a016b6b7871f8b2c82c04ef91271007e8c4502fc28574f88913bd7629bb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page