IMDb 10-Point Ratings on Letterboxd Script
This document provides a comprehensive overview, installation guide, and usage instructions for the "IMDb 10-Point Ratings on Letterboxd" Tampermonkey script.
1. Description
This script enhances your Letterboxd browsing experience by seamlessly integrating IMDb's familiar 10-point rating system directly onto Letterboxd film pages. Instead of having to open a new tab to check a movie's IMDb score, this script fetches and displays it for you, styled to look exactly like the modern IMDb rating component.
2. Features
- IMDb Rating Display: Shows the movie's rating on the classic 10-point scale.
- Vote Count: Displays the total number of user ratings from IMDb, formatted for readability (e.g., "618.3K").
- Authentic Styling: The rating is presented in a component that mimics the modern, dark-theme IMDb design, complete with the gold star icon.
- Prominent Placement: The IMDb rating is injected at the top of the right-hand sidebar on a film's page, directly above the "Watch," "Like," and "Watchlist" buttons for immediate visibility.
- Automatic & Seamless: The script runs automatically in the background. Simply navigate to any Letterboxd film page, and the rating will appear within a second or two.
3. How It Works
The script is lightweight and efficient. When you load a Letterboxd film page, it performs the following steps:
- Finds the Link: It automatically locates the official IMDb link provided on the Letterboxd page.
- Fetches Data: It uses the IMDb ID from that link to securely request rating information from an external movie database API in the background.
- Injects the Rating: Once the data is received, the script dynamically creates the styled rating component and places it on the page for you to see.
4. Installation and Setup
Follow these steps to get the script running in your browser.
Step 1: Install a Userscript Manager
You need a browser extension to run userscripts. Tampermonkey is the most popular choice.
Step 2: Install the Script
- Click the Tampermonkey icon in your browser and select "Dashboard".
- Click on the
+ tab to create a new script.
- Delete all the pre-filled text in the editor.
- Copy the entire code from the script you were provided.
- Paste the code into the empty editor in Tampermonkey.
- Go to
File > Save.
Step 3: Disable Conflicting Scripts
This is a crucial step. If you have any other userscripts that also show IMDb or other ratings on Letterboxd (like the original "MoreMovieRatings" script), you must disable them. Running two scripts that try to modify the same part of a page will cause conflicts, and one or both may fail to work.
5. Usage
Once installed, the script requires no user interaction.
- Browse Letterboxd: Simply navigate to any film page on
letterboxd.com.
- Wait a Moment: The script needs about 1-2 seconds to fetch the data from the internet. You will see a "Loading IMDb Rating..." message, which will then be replaced by the styled rating component.
