treysu/letterboxd-plex-sync repository overview

⁠🎭 Letterboxd Plex Sync

Letterboxd Plex Sync is a tool designed to sync your Letterboxd⁠ user data (ratings, watch history, and watchlists) to your Plex⁠ server, keeping your viewing stats up to date between both platforms!

GitHub Repo⁠ 👈

⁠🔧 Features

• Syncs your Letterboxd watchlist, watched status, and ratings with Plex.
• Uses the Plex API and Letterboxd Stats library for seamless integration.
• Supports cron job scheduling for regular syncing.
• Environment-variable-based configuration for easy setup.
• Dockerized for easy deployment with Docker or Docker Compose.

⁠🛠️ Environment Variables

• PLEX_BASEURL: URL for your Plex server.
• PLEX_TOKEN: Plex API token.
• LB_USERNAME / LB_PASSWORD: Letterboxd credentials.
• TMDB_API_KEY: TMDB API key for metadata fetching.
• Optional flags to control sync behavior: SYNC_WATCHLIST, SYNC_WATCHED, SYNC_RATINGS.
• Customize cron schedule: CRON_SCHEDULE (default: every day at 4:00AM)

⁠🛠️ How to Use

⁠Docker Compose Example:

---
version: "3"
services:
  letterboxd-plex-sync:
    image: treysu/letterboxd-plex-sync:latest
    container_name: letterboxd-plex-sync
    restart: unless-stopped
    env_file:
      - ./letterboxd.env
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - ./resources:/app/resources:rw

⁠Docker Run Example:

docker run -d \
  --name letterboxd-plex-sync \
  --env-file letterboxd.env \
  -v /etc/localtime:/etc/localtime:ro \
  -v ./resources:/app/resources:rw \
  treysu/letterboxd-plex-sync:latest