/TraktRater

TraktRater is a tool written in C# to help users transfer user episode, show and movie user ratings and watchlists from multiple media database sites around the web.

Primary LanguageC#

TraktRater

TraktRater is a tool written in C# to help users transfer user episode, show and movies ratings from multiple media database sites around the web to the popular social media site trakt.tv.

Users can also use this tool to remove any user data from their account at trakt.tv or export their personal data to CSV files.

DOWNLOADS

If you enjoy using this tool, consider donating below to encourage continued development: https://www.paypal.me/damienlhaynes

Usage

  • First ensure you are running on a Windows Platform with .NET Framework 4.7.2 installed. TraktRater can run on Mac OS and Linux, however you need to execute using Mono.
  • Download the latest TraktRater release from the repository downloads section.
  • Run the TraktRater.exe tool from the download location.
  • Allow the application to access your account from the Login tab:
    • First you need to authorise TraktRater to access your account. Once you have authorised, you need to enter the 8-digit code in the textbox provided. You now have up to 15 mins to start an import before the pin-code has expired. If you start import with-in 15 mins and TraktRater successfully logs in, the application will no longer require authorisation from you. You can request again if you wish by clicking on the link provided e.g. authorise for a another user.
  • Enter in any details from 3rd Party data sources such as your thetvdb.com account identifier or IMDb CSV file(s). If you leave any information from the data sources blank then it will be ignored on import.
  • If you wish to mark episodes and movies as watched if you have rated them, then keep the corresponding option checked, otherwise uncheck.
  • Press the Start Import button.

Data Sources

The following data sources are currently supported by this tool:

IMDb

The IMDb provider supports tv show, episode and movie ratings. TraktRater also supports import of your watchlist from IMDb to trakt.tv. Import can either be via CSV export (recommended) or by scraping online using your user id:

  • Login to IMDb.
  • Click on your Username link in the top right hand corner of page.
  • From the Quick Links table click on Ratings.
  • Click on the menu drop-down in the top right of the table and select Export.
  • Save the csv file to a folder on your computer.
  • In the TraktRater tool, enter in the filename in the textbox provided.
  • Repeat process to export your Watchlist.csv file and Custom lists, if you don't want to import your watchlist then keep field(s) empty.

If you choose to do a Web Scrape, ensure your profile is marked as Public otherwise it will fail. Your IMDb User ID can be found from the address bar in your browser window, look for something like ur13828119. Custom list import via webscrape is currently not supported. Its recommended that you use CSV mode if you encounter any issues.

TVDb

The TVDb provider supports tv show and episode ratings. TraktRater requires your Account Identifier, NOT your username. You can find your account id by following these steps:

  • Login to TVDb.
  • Click on the account link in the toolbar.
  • Copy the 16 character string in the Account Identifier textbox.
  • Paste the account identifier into the corresponding text field in TraktRater.

We also cache any data we get from TVDb so that subsequent retries do not take as long. The series cache expires every 7 days and the UserRatings every 1 day. The cache folder is located here:

WinVista/Windows7 : C:\Users\$(username)\AppData\Roaming\TraktRater
WinXP             : C:\Documents and Settings\Application Data\$(username)\TraktRater

TMDb

The TMDb provider supports movie/show ratings and watchlists. TraktRater requires access to your account information. To allow Trakt Rater access to your account info follow these steps:

  • Click on the Start Request Process in the Trakt Rater application.
  • When a valid request token is received from TMDb you will be re-directed in a web-browser to approve or deny Trakt Rater.
  • Click on the Allow Button in web-browser.
  • Enable or disable the *Sync Watchlist button. Ratings are done by default.
  • You are now ready to import ratings from TMDb, exit the browser and return to the application. If you do not start importing with-in 60 minutes or restart the application before importing then you will need to repeat process.

If at any time you want to disable access or request permission again you can click on the Disable TMDb Support link and then repeat steps above.

Listal

The Listal provider supports tv shows and movie ratings. TraktRater also supports import of your wanted list from Listal, it converts this into a watchlist. Once you login to the listal website, you can follow the link provided in the UI to download the respective XML files for Shows and Movies.

  • Logon to www.listal.com if you haven't already.
  • Download your Movies and/or Shows from Export
  • Use the Movie and/or Show text boxes to browse to the downloaded XML files.

Criticker

The Criticker provider supports movie ratings.

  • Logon to www.criticker.com if you haven't already.
  • Click on your User Profile.
  • Click on your Full Rankings List.
  • From the Export box, right click on the CSV icon and select Save Link As....
  • Save the file to your hard drive.
  • Select your file from the TraktRater application.
  • You're now ready to Import!.

Letterboxd

The Letterboxd provider supports movie ratings and watched data.

  • Logon to www.letterboxd.com if you haven't already.
  • Open your Profile page
  • Click on your Export your Data and follow the prompts to export data as a zip archive.
  • Save the file to your hard drive.
  • Extract the files in the zip file to a directory on your hard-drive.
  • Select the corresponding files (watched, ratings, diary) from the TraktRater application.
  • You're now ready to Import!.

Flixster

The Flixster provider supports movie ratings from multiple sources such as Facebook and Rotten Tomatoes.

  • Logon to www.flixster.com if you haven't already.
  • Open Settings page with your export data Export
  • Copy your numeric User ID from the URL in the address bar
  • You're now ready to Import!.

iCheckMovies

The iCheckMovies provider supports watchlists, toplists and lists of watched movies.

  • Logon to www.icheckmovies.com
  • Go to the list you want to import
  • Click the button for exporting to csv (may require paid subscription)
  • Save file to your hard drive.
  • Select the file in the TraktRater application
  • You're now ready to import!.

MovieLens

The MovieLens provider supports movie ratings and watchlists (aka wishlist).

  • Logon to www.movielens.org
  • Go to your account settings page
  • Click on the import or export menu item
  • Export your ratings, watchlist and activity log (as csv) to disk
  • Select the corresponding file(s) in the TraktRater application
  • You're now ready to import!.

NB: the activity file is optional and only used to get the date/time a movie was rated/watched.

Contributing

  1. Fork it.
  2. Create a branch (git checkout -b my_traktrater)
  3. Commit your changes (git commit -am "Added new rating source")
  4. Push to the branch (git push origin my_traktrater)
  5. Create an Issue with a link to your branch