[{"_1":2,"_183":-5,"_184":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_181":182},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_89":-5,"_90":91,"_170":-5,"_171":11,"_172":21,"_173":11,"_174":-5,"_175":11,"_176":-5,"_177":178,"_179":92,"_180":-7},"canonicalUrl","https://hub.docker.com/r/stegschreck/rats/builds","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","stegschreck","reponame","rats","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":11,"_73":33,"_74":75,"_80":21,"_81":82,"_86":33,"_87":88},"categories",[],"content_types",[44],"image","date_registered","2017-07-20T17:15:26.816079Z","description","This project serves for parsing your ratings from one movie tracking / rating website to another.","is_private","last_updated","2021-07-29T09:16:40.671419Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",4898,"repository_type","star_count",2,"status",1,"status_description","active","source","collaborator_count",0,"full_description","

\n \n

\n\n# RatS\n\n[![Build Status](https://github.com/StegSchreck/RatS/workflows/CI/badge.svg)](https://github.com/StegSchreck/RatS/actions?query=workflow%3ACI)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/c0601ed8ba1a4ba5ac1a205521f00622)](https://www.codacy.com/app/StegSchreck/RatS?utm_source=github.com&utm_medium=referral&utm_content=StegSchreck/RatS&utm_campaign=Badge_Grade)\n[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/c0601ed8ba1a4ba5ac1a205521f00622)](https://www.codacy.com/app/StegSchreck/RatS?utm_source=github.com&utm_medium=referral&utm_content=StegSchreck/RatS&utm_campaign=Badge_Coverage)\n[![Docker Build Status](https://img.shields.io/docker/cloud/build/stegschreck/rats.svg?logo=docker)](https://hub.docker.com/r/stegschreck/rats/builds)\n[![Docker Image Size](https://img.shields.io/docker/image-size/stegschreck/rats.svg?logo=docker)](https://hub.docker.com/r/stegschreck/rats/builds)\n[![License](https://img.shields.io/github/license/StegSchreck/RatS.svg)](https://github.com/StegSchreck/RatS/blob/master/LICENSE)\n[![Latest Release](https://img.shields.io/github/release/StegSchreck/RatS.svg?logo=github)](https://github.com/StegSchreck/RatS/releases)\n\nThis project serves for analyzing, and transferring your ratings from one movie tracking / rating website to another.\n\nThe goal of this project is to have a universal tool which can transfer your ratings from any site to another without the need of any manual steps like configuring an API access or whatever. Just configure your credentials (see steps'below), start the tool and relax.\n\nThis also works if your lists are marked as private, as this tool uses a browser to login and get the content.\n\n## How do I use this?\n\n### Natively on the command line\nThis project is currently still under development. Please be patient, as I'm only working on this every once in a while.\n\n1. Make sure you have Python3, Firefox and Xvfb installed on your system.\n This project is designed to run on Linux.\n2. Checkout the project\n `git clone https://github.com/StegSchreck/RatS.git && cd RatS`\n3. Install the requirements with pip for Python3\n `pip3 install -r requirements.txt`\n4. Install Geckodriver\n * Use your system's package manager (if it contains Geckodriver)\n * Arch Linux: `pacman -S geckodriver`\n * MacOS: `brew install geckodriver`\n * Or execute `sudo ./InstallGeckodriver.sh`.\n For this you will need to have tar, wget and curl installed.\n5. Set your credentials\n 1. Copy the `credentials.cfg.orig` file to `credentials.cfg` and insert your credentials for the sites you need there (without any quotation marks etc.).\n\n Copying the file will conserve the possibility to do a `git pull` later on without overwriting your credentials.\n 2. Alternatively, you can set the credentials via environment variables. For example, if you want to set the credentials for your IMDB and Trakt accounts you would need to set these environment variables:\n ```sh\n export IMDB_USERNAME=abc@def.de\n export IMDB_PASWORD=def\n export TRAKT_USERNAME=abc\n export TRAKT_PASWORD=def\n ```\n It is important to use the variable names completely in uppercase!\n\n 3. The third way is to set the environment variables when running the transfer script, like this:\n `IMDB_USERNAME=abc@def.de IMDB_PASWORD=def TRAKT_USERNAME=abc TRAKT_PASWORD=def python3 transfer_ratings.py --source trakt --destination imdb`\n\n The credentials in environment variables are overruling the ones in the `credentials.cfg` file.\n6. Execute the script with **Python3**\n `python3 transfer_ratings.py --source trakt --destination movielens`\n\n This will first parse your ratings in Trakt, save them in a JSON file for later use and then try to find those\n movies in Movielens an put your rating there. Notice: This will also overwrite rating you already did set there before.\n\n This script will take some minutes. Relax. You can follow the progress in console output.\n\n For more information about how to use the script, you can call\n `python3 transfer_ratings.py --help`\n7. At the end, the script will print out how many movies were successfully posted. Afterwards all the movies which\n couldn't be found are printed out, so you can check them manually. The failed movie are also exported to a JSON file, so you can easily try them again (see below).\n\n### Inside a Docker container\n_Please note: This is currently not working on Windows. See issue #19_\n\n1. Create a credentials configuration in your home folder, e.g.: `touch ~/.RatS.cfg`\n2. Configure your credentials in the file you just created, e.g.:\n\n ```\n [Trakt]\n USERNAME = abc\n PASSWORD = def\n ```\n\n Please see the RatS/credentials.cfg.orig in this repository as a template. Please enter your credentials as they are, without any quotation marks.\n3. Get the Docker image: `docker pull stegschreck/rats`\n4. Run the script: `docker run -it -v ~/.RatS.cfg:/RatS/RatS/credentials.cfg stegschreck/rats python3 transfer_ratings.py --source trakt --destination movielens`\n\n The `-v ~/.RatS.cfg:/RatS/RatS/credentials.cfg` option will load the credentials file you just created from your home directory into the docker container, so that the script can use it.\n\n You will see the progress in your console. If you want to run this in the background, you can add the option `-d` to the docker run command to hide the output.\n5. If you want to run the command again, simply run `docker start -ai `.\n You can find the container id using `docker ps -a` or by running `docker ps -q -l`, if you haven't started any other containers in the meanwhile.\n6. After the successful run of the transfer script, you may remove the docker container using `docker rm `.\n\n### Command line call parameters\n1. the first argument (`--source`) is the site where the ratings are parsed from (see [Available Parsers](#currently-available-parsers))\n2. the second argument (`--destination`) is the site where the ratings should be posted (inserted) to (see [Available Inserters](#currently-available-inserters))\n\nYou can also omit the destination argument in order to just save the parsing results to a JSON file. You might insert the saved results anytime later. (see [below](#trying-again-with-former-export-data))\n\nFurthermore, you can define multiple destinations, e.g. like this: `python3 transfer_ratings.py --source trakt --destination movielens --destination imdb` in order to use the same data from the parser in this run for multiple destinations.\n\n### Mandatory\n`-s` / `--source`: the site where the ratings are parsed from (see [Available Parsers](#currently-available-parsers)). This parameter must be given in even if you use the `-f` option.\n\n### Optional\n`-d` / `--destination`: the site where the ratings should be posted (inserted) to (see [Available Inserters](#currently-available-inserters)).\nIf you don't specify any destination, the ratings are only parsed and saved locally.\n\n`-D` / `--all-destinations`: try to insert the parsed ratings to all configured sites for which valid credentials can be found\n\n`-f` / `--file`: read ratings from a previous run instead of parsing them\n\n`-v` / `--verbose`: increase output verbosity (i.e. print the generated predictions in the console)\n\n`-x` / `--show_browser`: show the browser doing his work (this might help for debugging))\n\n`-h` / `--help`: Display the help, including all possible parameter options\n\n#### Currently Available Parsers\n* AlloCine\n* Criticker\n* FilmAffinity\n* Filmtipset\n* ~~Flixster~~ deactivated until new account feature is implemented at Flixster\n* iCheckMovies\n * please configure the conversion value for the like/dislike into a numeric rating yourself in the `credentials.cfg`\n* IMDB (with IMDB account)\n* Letterboxd\n* Listal\n* Movielens\n* MoviePilot\n* Plex (locally hosted server)\n* Rotten Tomatoes\n* TMDB (The Movie Database)\n* Trakt\n\n#### Currently Available Inserters\n* AlloCine\n* Criticker\n* FilmAffinity\n* Filmtipset\n* ~~Flixster~~ deactivated until new account feature is implemented at Flixster\n* iCheckMovies\n * please configure the boundaries for the ratings conversion yourself in the `credentials.cfg`\n* IMDB (with IMDB account)\n* Letterboxd\n* Listal\n* Metacritic\n* Movielens\n* MoviePilot\n* Plex (locally hosted server)\n* Rotten Tomatoes\n* TMDB (The Movie Database)\n* Trakt\n\n

\n \n

\n\n### Trying again with former export data\nDepending on what you used in the first run:\n\n#### ... using the command line\nYou can re-use the data you parsed before, without parsing again. This will help you, if you want to distribute from one source to multiple destinations. The parser tells you in which file he saved his result, the folder is `./RatS/exports`. You can use this data by calling the script for example this way:\n\n`python3 transfer_ratings.py --source trakt --destination movielens --file 20170721191143_Trakt.json`\n\nPlease notice, that the `--source` argument is still needed in order to identify which data to use from the given file for the inserter.\n\nFurthermore: This section is meant to be used with the native command line version. Docker containers work differently.\n\n#### ... using Docker\n1. After the first run of the Docker container: (assuming you didn't start any other Docker containers in the meanwhile)\n\n * save the state of the container (including the saved data): ```docker commit user/RatS```\n * lookup the JSON file the script saved into the exports folder: `docker run -it user/RatS ls -l RatS/exports/` (take the latest JSON file)\n\n2. Run the container again, e.g. with a different destination `docker run -it -v ~/.RatS.cfg:/RatS/RatS/credentials.cfg user/RatS python3 transfer_ratings.py --source trakt --destination imdb --file 20170721191143_Trakt.json`\n\n#### Switching between environments\nYou can copy the exported JSON from/to the Docker container if you like. I don't recommend this if you have no experience with docker. If you have, you already know what to do here ;)\n\n## Problem shooting\n\n### Script aborts because of Timeouts\nIt might occasionally happen, that the script runs into errors caused by the page loading too slow. In the past, this was quite an issue. I now tried to build a mechanism with dynamically increasing timeouts. Therefore, the script sleeps for one second after failing the first try (effective for multiple problematic locations in the code), waiting two seconds after the second try failed, and so on. The maximum number of tries is ten. If this is reached, the error gets re-raised and the script will fail.\n\n### Script aborts with WebDriverException\nIf you recently updated your Firefox, you might encounter the following exception during the login attempt of the parser:\n\n```\nselenium.common.exceptions.WebDriverException: Message: Expected [object Undefined] undefined to be a string\n```\n\nThis can be fixed by installing the latest version of [Mozilla's Geckodriver](https://github.com/mozilla/geckodriver) by running again the _Install Geckodriver_ command mentioned [above](#natively-on-the-command-line).\n\n### Script aborts with MoveTargetOutOfBoundsException while inserting to IMDB\nIMDB shows special promotional banners for certain movies. If they are too big, they will cause the ratings component to be out of the viewport of the browser and the script fails with something like:\n\n```\nselenium.common.exceptions.MoveTargetOutOfBoundsException: Message: (620, 629) is out of bounds of viewport width (720) and height (538)\n```\n\nFor now, the easiest solution is to run the script on your console with the `-x` flag. This will display the browser to you in a maximized window which then has a bigger viewport and prevent the error.\n\n### Login attempt does not work\nThis can have multiple explanations. One is, that you are using a password which starts or ends with a space character. RatS is currently not capable of dealing with that. If your credentials have a space character in the middle though, it will work fine.\n\n### Trakt aborts with AttributeError\nWhile tying to login to Trakt, the script aborts with this error message:\n\n```\n===== Trakt: performing login\nTraceback (most recent call last):\n[...]\nAttributeError: 'NoneType' object has no attribute 'find'\n```\n\nThis was observed to happen when the credentials were configured to use the email address for login. Try to set your username instead.\n\n## You are missing a feature or noticed something is wrong?\nBefore submitting a bug ticket, I would ask you to check first whether all dependencies are up-to-date, especially `geckodriver`.\n\nPlease [write a ticket](https://github.com/StegSchreck/RatS/issues/new/choose), I will have a look as soon as I can.\n\n## Where does the name come from?\nThe name for this project comes from the first letters of \"**rat**ing **s**ynchronisation\". It is that simple. It is also a reference to the movie \"Departed\".\n\n## Acknowledgments\nThis project uses a free license for PyCharm by benefiting from [JetBrains](https://www.jetbrains.com/?from=RatS)' open source community support program.\n\n

\n \n

\n","has_starred","hub_user","immutable_tags_settings",{"_76":11,"_77":78},"enabled","rules",[79],".*","is_automated","permissions",{"_83":21,"_84":11,"_85":11},"read","write","admin","user","storage_size",36878740228,"orgData","recentTags",[92,130,140,150,160],{"_93":44,"_94":95,"_96":97,"_98":99,"_100":101,"_50":119,"_120":95,"_121":33,"_122":56,"_57":123,"_124":125,"_126":110,"_127":119,"_128":66,"_129":21},"content_type","creator",988548,"full_size",313411275,"id",13166188,"images",[102],{"_103":104,"_105":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":108,"_116":-5,"_117":97,"_63":66,"_118":-5},"architecture","amd64","digest","sha256:d1a03efbd42bbee3ac3869ea94eab7a10f4002f2e14769ea41eabe3080dfb6ee","features","","last_pulled","2026-09-26T12:20:27.207252299Z","last_pushed","2019-12-30T21:03:00Z","os","linux","os_features","os_version","size","variant","2019-12-30T21:03:00.018333Z","last_updater","last_updater_username","media_type","latest","repository",1668700,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_93":44,"_94":95,"_96":131,"_98":132,"_100":133,"_50":138,"_120":95,"_121":33,"_122":56,"_57":139,"_124":125,"_126":136,"_127":138,"_128":66,"_129":21},388372487,14063636,[134],{"_103":104,"_105":135,"_107":108,"_109":136,"_111":137,"_113":114,"_115":108,"_116":-5,"_117":131,"_63":66,"_118":-5},"sha256:5691f55e64cd98e42bc50238edfc9dbc4cea218aa15ff2888108b3e1565acd46","2026-09-26T19:33:05.298941007Z","2021-07-29T09:16:41Z","2021-07-29T09:16:40.372932Z","master",{"_93":44,"_94":95,"_96":141,"_98":142,"_100":143,"_50":148,"_120":95,"_121":33,"_122":56,"_57":149,"_124":125,"_126":146,"_127":148,"_128":66,"_129":21},313411050,81166947,[144],{"_103":104,"_105":145,"_107":108,"_109":146,"_111":147,"_113":114,"_115":108,"_116":-5,"_117":141,"_63":66,"_118":-5},"sha256:370c119c3fcea1b14234bc4ee58c9d4460fbccf494a4d3ca0b81c551423b674f","2026-09-26T19:28:08.434718925Z","2019-12-30T21:08:43Z","2019-12-30T21:08:42.783585Z","v0.12.1",{"_93":44,"_94":95,"_96":151,"_98":152,"_100":153,"_50":158,"_120":95,"_121":33,"_122":56,"_57":159,"_124":125,"_126":156,"_127":158,"_128":66,"_129":21},325646720,59006682,[154],{"_103":104,"_105":155,"_107":108,"_109":156,"_111":157,"_113":114,"_115":108,"_116":-5,"_117":151,"_63":66,"_118":-5},"sha256:460632eb83cc1b464da90d402aa1095b471d2be2179e85f65690929be4e51a40","2026-09-26T12:19:26.715773233Z","2019-06-16T13:28:33Z","2019-06-16T13:28:32.891188Z","v0.11.6",{"_93":44,"_94":95,"_96":161,"_98":162,"_100":163,"_50":168,"_120":95,"_121":33,"_122":56,"_57":169,"_124":125,"_126":166,"_127":168,"_128":66,"_129":21},455077206,51693417,[164],{"_103":104,"_105":165,"_107":108,"_109":166,"_111":167,"_113":114,"_115":108,"_116":-5,"_117":161,"_63":66,"_118":-5},"sha256:49beeb2043f837bbb310f882481a4f1b6a3ae91c8ac6765858677e647398e0f7","2026-09-26T13:45:48.690577284Z","2019-04-02T21:36:26Z","2019-04-02T21:36:25.474458Z","v0.11.5","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.builds",{"_31":11,"_36":-5},"actionData","errors"]