letterboxd-streaming-providers

KO | EN

gitlite — search

#python #javascript #deep-learning #react #nodejs #html #ai #nextjs #portfolio #web-development #telegram #docker

letterboxd-streaming-providers

★ 35 Open GitHub ↗

This extension adds a filter for streaming providers (e.g., Netflix, Amazon Prime Video) to Letterboxd (https://www.letterboxd.com/), so that you can see, which movies are included in your streaming flat rate.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Letterboxd Streaming Providers ![Logo](https://raw.githubusercontent.com/adlerzei/letterboxd-streaming-providers/main/extension/icons/logo_final_48.png)

[![Project status: active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![CI](https://github.com/adlerzei/letterboxd-streaming-providers/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/adlerzei/letterboxd-streaming-providers/actions/workflows/ci.yml)
[![Project releases](https://img.shields.io/github/release/adlerzei/letterboxd-streaming-providers)](https://github.com/adlerzei/letterboxd-streaming-providers/releases)
[![Project contributors](https://img.shields.io/github/contributors/adlerzei/letterboxd-streaming-providers)](https://github.com/adlerzei/letterboxd-streaming-providers/graphs/contributors)
[![Project license](https://img.shields.io/github/license/adlerzei/letterboxd-streaming-providers)](https://github.com/adlerzei/letterboxd-streaming-providers/blob/main/LICENSE)

## What?
This is an extension for common web browsers coded using the WebExtensions API.

## Main Features
This extension adds a filter for streaming services (e.g., Netflix, Amazon Prime Video) to [Letterboxd](https://letterboxd.com/), to make it possible for you to see, which movies are included in your streaming flat rate.

### How?
The extension uses the TMDb API to access the streaming information that is provided by JustWatch.

### Which browser to use?
The extension can be added to all Chromium-based browsers (Chrome, Edge, Opera, Brave, etc.) and Firefox.

#### Chrome Web Store
[Letterboxd Streaming Providers at the Chrome Web Store](https://chrome.google.com/webstore/detail/letterboxd-streaming-prov/egmanfnfgmljjmdncfoeghfmflhlmhpj)

#### Firefox Add-ons (AMO)
[Letterboxd Streaming Providers at AMO](https://addons.mozilla.org/en-US/firefox/addon/letterboxd-streaming-providers/)

### Which countries are supported?
All countries supported by JustWatch are also supported by this extension.

At the time of writing, these are:<br>
Andorra, United Arab Emirates, Antigua and Barbuda, Albania, Angola, Argentina, Austria, Australia, Azerbaijan, Bosnia and Herzegovina, Barbados, Belgium, Burkina Faso, Bulgaria, Bahrain, Bermuda, Bolivia, Brazil, Bahamas, Belarus, Belize, Canada, Congo, Switzerland, Cote D'Ivoire, Chile, Cameroon, Colombia, Costa Rica, Cuba, Cape Verde, Cyprus, Czech Republic, Germany, Denmark, Dominican Republic, Algeria, Ecuador, Estonia, Egypt, Spain, Finland, Fiji, France, United Kingdom, French Guiana, Ghana, Gibraltar, Guadaloupe, Equatorial Guinea, Greece, Guatemala, Guyana, Hong Kong, Honduras, Croatia, Hungary, Indonesia, Ireland, Israel, India, Iraq, Iceland, Italy, Jamaica, Jordan, Japan, Kenya, South Korea, Kuwait, Lebanon, St. Lucia, Liechtenstein, Lithuania, Luxembourg, Latvia, Libyan Arab Jamahiriya, Morocco, Monaco, Moldova, Montenegro, Madagascar, Macedonia, Mali, Malta, Mauritius, Malawi, Mexico, Malaysia, Mozambique, Niger, Nigeria, Nicaragua, Netherlands, Norway, New Zealand, Oman, Panama, Peru, French Polynesia, Papua New Guinea, Philippines, Pakistan, Poland, Palestinian Territory, Portugal, Paraguay, Qatar, Romania, Serbia, Russia, Saudi Arabia, Seychelles, Sweden, Singapore, Slovenia, Slovakia, San Marino, Senegal, El Salvador, Turks and Caicos Islands, Chad, Thailand, Tunisia, Turkey, Trinidad and Tobago, Taiwan, Tanzania, Ukraine, Uganda, United States of America, Uruguay, Holy See, Venezuela, Kosovo, Yemen, South Africa, Zambia, Zimbabwe

## Contributing

### Developing
- `npm install` - Installs all dependencies.
- `npm run build` - Builds the Firefox (.xpi) and the Chrome/Opera (.zip) builds.

For local development, edit `extension/settings/api.json` and insert your TMDB API token in debug mode. If you don't have one, you can request one [here](https://www.themoviedb.org/documentation/api).

```json
{
  "tmdb": "YOUR_TMDB_TOKEN_HERE",
  "debug": true
}
```

To avoid accidentally committing local token changes, mark the file as skip-worktree:

```bash
git update-index --skip-worktree extension/settings/api.json
```

For CI and release builds, GitHub Actions writes an obfuscated token into `api.json` using the `TMDB_TOKEN` repository secret and a per-build nonce.

Create the secret in your repository here:
Settings -> Secrets and variables -> Actions -> New repository secret

- Name: `TMDB_TOKEN`
- Value: your raw TMDB token

### How to test?
1. Run `npm install` once at the beginning of your development.
2. Load the extension in your browser.

In Chrome: 
- go to `chrome://extensions`
- activate developer mode 
- then
    - click `load unpacked extension` 
    - load the `/extension` folder 
- or
    - drag & drop the Chrome build file from `/builds` into the tab.

For GitHub Actions artifacts, note that the downloaded artifact is a GitHub wrapper archive. Extract it first to get the actual `.zip` or `.xpi` build file inside.
    
In Firefox:
- go to `about:debugging`
- then
    - load `extension/manifest.json`
- or
    - load the Firefox build file from `/builds`.

### Donations
If you like my work, you can support me via [PayPal](https://www.paypal.me/ChristianZei/5). Thank you!

## Credits
Thanks to everyone using, supporting and contributing to the extension. Philipp Emmer is especially mentioned for the idea behind this extension.

This is a third party extension and is not related to the Letterboxd developer team in any way. This product uses the TMDb API but is not endorsed or certified by TMDb. The extension also uses information provided by JustWatch but is not endorsed or certified by JustWatch.

## Contributors
<a href="https://github.com/adlerzei/letterboxd-streaming-providers/graphs/contributors">
  <img src="https://contributors-img.web.app/image?repo=adlerzei/letterboxd-streaming-providers" />
</a>

Made with [contributors-img](https://contributors-img.web.app).

letterboxd-streaming-providers

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README