Plex to Letterboxd Exporter
Exports Plex watch history and ratings to a Letterboxd‑compatible CSV file using TMDB IDs for reliable matching.
Install
From PyPI:
pip install plex-letterboxd
Or with uv:
uv pip install plex-letterboxd
From source:
git clone https://github.com/brege/plex-letterboxd.git
cd plex-letterboxd
pip install .
Or with uv:
git clone https://github.com/brege/plex-letterboxd.git
cd plex-letterboxd
uv pip install .
Configure
There are two ways to include your Plex token.
Option 1: Set your Plex token in config.yaml:
plex:
url: http://your-plex-server:32400
token: PLEX_TOKEN
timeout: 60
Option 2: Kometa users may source Kometa's config in this project's config.yaml:
kometa:
config_path: ./path/to/Kometa/config.yml
Exporter options are in config.yaml.
- export: output, after, before, user, library
- csv: rating, review, max_rows, genres, tags, rewatch, mark_rewatch
See config.example.yaml for available options.
Usage
- List users
plex-letterboxd --list-users
- Export for a specific user
plex-letterboxd --user USERNAME --output plex-export.csv
- Export a date range
plex-letterboxd \
--user USERNAME \
--after 2024-01-01 \
--before 2024-12-31 \
--output plex-export-2024.csv
Import at https://letterboxd.com/import/
See plex-letterboxd --help for CLI options.
Output CSV Columns
| Field | Description |
|---|---|
tmdbID |
TMDB ID for precise matching |
Title |
Movie title |
Year |
Release year |
Directors |
Director names |
WatchedDate |
When you watched it (YYYY‑MM‑DD) |
Rating |
Your rating (0.5–5.0), if enabled |
Tags |
Genres and/or custom tags, if enabled |
Rewatch |
Whether it's a rewatch |
Automated Exports
Set up a systemd timer for automated monthly exports with CSV checkpointing.
Setup Timer
Monthly
bash <(curl -s https://raw.githubusercontent.com/brege/plex-letterboxd/refs/heads/main/systemd/install.sh)
Or weekly
bash <(curl -s https://raw.githubusercontent.com/brege/plex-letterboxd/refs/heads/main/systemd/install.sh) weekly
The timer will run the exporter on your chosen schedule, producing CSV files in ~/.config/plex-letterboxd/data/. Configure the output data directory via config.yaml to change.
I suggest running this on the same machine Plex runs on, since it's typically always online.
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file plex_letterboxd-0.8.tar.gz.
File metadata
- Download URL: plex_letterboxd-0.8.tar.gz
- Upload date:
- Size: 23.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c30d7fdecabd2b164a6e9261f7b879a791396211d1b5a280ba8dd4e573144b27
|
|
| MD5 |
e24e46ca34af93f05a97ef07f81f1ce0
|
|
| BLAKE2b-256 |
4233f173a06a67235251cf642201cd4a5f92e715e92e10022e0b583f9d5ea546
|
Provenance
The following attestation bundles were made for plex_letterboxd-0.8.tar.gz:
Publisher:
publish.yml on brege/plex-letterboxd
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
plex_letterboxd-0.8.tar.gz -
Subject digest:
c30d7fdecabd2b164a6e9261f7b879a791396211d1b5a280ba8dd4e573144b27 - Sigstore transparency entry: 2256569086
- Sigstore integration time:
-
Permalink:
brege/plex-letterboxd@d6679315ea1029202fcb0a4588f3e4b7e06c1b64 -
Branch / Tag:
refs/tags/v0.8 - Owner: https://github.com/brege
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@d6679315ea1029202fcb0a4588f3e4b7e06c1b64 -
Trigger Event:
release
-
Statement type:
File details
Details for the file plex_letterboxd-0.8-py3-none-any.whl.
File metadata
- Download URL: plex_letterboxd-0.8-py3-none-any.whl
- Upload date:
- Size: 23.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
21fcd4f00343c4dcaa5ad02d6c0474042d8ede6dd32c8d5968762a95a2868295
|
|
| MD5 |
c4cfb0dd168a716ee7ccd5e656fc120e
|
|
| BLAKE2b-256 |
7746f73fb2d7a1576092e7ebe1ab6b8e0927cd873747bd59ddf4efd027de7500
|
Provenance
The following attestation bundles were made for plex_letterboxd-0.8-py3-none-any.whl:
Publisher:
publish.yml on brege/plex-letterboxd
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
plex_letterboxd-0.8-py3-none-any.whl -
Subject digest:
21fcd4f00343c4dcaa5ad02d6c0474042d8ede6dd32c8d5968762a95a2868295 - Sigstore transparency entry: 2256569096
- Sigstore integration time:
-
Permalink:
brege/plex-letterboxd@d6679315ea1029202fcb0a4588f3e4b7e06c1b64 -
Branch / Tag:
refs/tags/v0.8 - Owner: https://github.com/brege
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@d6679315ea1029202fcb0a4588f3e4b7e06c1b64 -
Trigger Event:
release
-
Statement type:
