https://github.com/tetrax-10/letterboxd-custom-images

Userscript to customize letterboxd posters and backdrops without letterboxd PATRON.
https://github.com/tetrax-10/letterboxd-custom-images

backdrop letterboxd letterboxd-script tmdb-api userscript

Last synced: 4 months ago
JSON representation

Userscript to customize letterboxd posters and backdrops without letterboxd PATRON.

• Host: GitHub
• URL: https://github.com/tetrax-10/letterboxd-custom-images
• Owner: Tetrax-10
• License: mit
• Created: 2024-09-02T17:13:42.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-09-29T17:50:17.000Z (4 months ago)
• Last Synced: 2024-10-14T00:42:41.109Z (4 months ago)
• Topics: backdrop, letterboxd, letterboxd-script, tmdb-api, userscript
• Language: JavaScript
• Homepage: https://tetrax-10.github.io/letterboxd-custom-images/
• Size: 12.1 MB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Letterboxd Custom Images

This userscript allows you to customize letterboxd posters and backdrops without letterboxd _PATRON_.

All the customization this userscript provides is local and won't be visible to other users.

## Installation

1. Install the [Tampermonkey](https://chromewebstore.google.com/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en) extension.

2. Then, [click here and press install](https://tetrax-10.github.io/letterboxd-custom-images/lci.user.js).

3. [Open settings](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/script_settings.jpg) and enter your TMDB API key (used by [image chooser](#screenshots-of-image-chooser) but optional).

4. Done! 🎉

### Screenshots

![menu.jpg](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/menu.jpg)

#### Original images

![film_before.jpg](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/film_before.jpg)

#### Customized images with this userscript

![film_after.jpg](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/film_after.jpg)




### Automatically display backdrops for less popular films

Letterboxd doesn't display backdrops for less popular films. So this script uses your TMDB Api to fetch backdrop automatically for those films and display them.

![missing_backdrop_before.jpg](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/missing_backdrop_before.jpg)

![missing_backdrop_after.jpg](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/missing_backdrop_after.jpg)




### How to open settings?

To open settings, click on the tampermonkey icon in your browser and click the gear icon. The gear icon will only appear if you are in a [letterboxd page](https://letterboxd.com/).



### Screenshots of settings menu

![settings_menu.jpg](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/settings_menu.jpg)

### Screenshots of image chooser

**_Note:_** **The image preview will only appear if you have entered your TMDB API key.** Without that, you can only enter image url manually in the text box.

![poster_chooser.jpg](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/poster_chooser.jpg)

![backdrop_chooser.jpg](https://raw.githubusercontent.com/Tetrax-10/letterboxd-custom-images/main/screenshots/backdrop_chooser.jpg)