An open API service indexing awesome lists of open source software.

https://github.com/loan-mgt/letterboxd-badge

Showcase your cinematic tastes in your README with a personalized Letterboxd badge!
https://github.com/loan-mgt/letterboxd-badge

badge cinema readme-profile

Last synced: 10 days ago
JSON representation

Showcase your cinematic tastes in your README with a personalized Letterboxd badge!

Awesome Lists containing this project

README

        


logo letterboxd badge

letterboxd-badge 🎬


Showcase your cinematic tastes in your README with a personalized Letterboxd badge!


## Usage
Generate a simple badge by adding the following markdown to your README:
```markdown
![my cinematic taste](https://letterboxd-badge.vercel.app/)
```
or with a custom redirect link
```markdown
[![my cinematic taste](https://letterboxd-badge.vercel.app/)]()
```
Illustration of the letterboxd badge:

![my cinematic taste](https://letterboxd-badge.vercel.app/qypol)

![my cinematic taste](https://letterboxd-badge.vercel.app/qypol?theme=colorMatch)

## Options / Customization

You can customize your URL by passing various options. Here’s an example of how to use them:

```
url?option1=valueofoption1&option2=valueofoption2
```

### Available Options:

| **Option** | **Description** | **Values** |
|-----------------|------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| `theme` | Choose the appearance theme for the display. | `classic`: Matches the Letterbox Dark theme.
`colorMatch`: Matches the theme to the film cover. |
| `index` | Specifies which review to display based on its index. | `number`: 0 for the most recent review, 1 for the one before that, etc. |

### Example:

To use the `classic` theme and show the second most recent review, your URL would look like this:

```
url?theme=classic&reviewIndex=1
```

## Important Note ❗
This is not an official Letterboxd service.

Here’s an improved version of your README with a better-structured table for clarity and easier reference: