Letterboxd Gallery Viewer

A web-based gallery viewer that displays your Letterboxd movie entries in a beautiful grid layout. This project fetches your Letterboxd RSS feed and renders it as an interactive gallery with movie posters and details.

This project is designed to be easy to customize and does not require anything to be downloaded! Once configured, the GitHub actions allow for fetching data and storing it in the remote repository, and deploying the code to GitHub Pages.

Keep reading for more details.

Architecture

Review this sequence diagram to understand how Letterboxd Gallery Viewer works.

Features

• Fetches and displays Letterboxd RSS feed entries
• Responsive gallery layout with movie posters
• Lightbox view for full review content
• Contact form with webhook integration
• Mobile-friendly design

Usage

1. Update the RSS feed URL in scripts/download_rss.py with your Letterboxd username
2. Run the Python script to download your feed
3. Open index.html in a web browser to view your movie gallery

Automated RSS Feed Updates

This project includes a GitHub Action workflow that automatically updates your Letterboxd RSS feed data:

1. The .github/workflows/download-data-and-assets.yml workflow runs every 6 hours to fetch your latest Letterboxd activity
2. It can also be triggered manually from the Actions tab in your repository
3. When new entries are found, the workflow commits and pushes the changes automatically

To use this feature after forking the repository:

1. Ensure your fork has GitHub Actions enabled
2. Update the RSS feed URL in scripts/download_rss.py with your Letterboxd username
3. The first workflow run will populate your gallery with your Letterboxd data

Deployment

This project is set up for deployment on GitHub Pages. To deploy:

1. Fork this repository
2. Go to your repository settings > Secrets and variables > Actions
3. Add a new secret named DISCORD_WEBHOOK_URL with your Discord webhook URL
4. Enable GitHub Pages in your repository settings
5. Push changes to the main branch to trigger deployment

The site will be automatically deployed to https://[your-username].github.io/letterboxd-viewer/

Contact

The gallery includes a contact form that sends messages through a Discord webhook. The webhook URL is configured through GitHub Actions environment variables for security.

Learn more about Discord Webhooks from this support article

---

Template Attribution

Multiverse by HTML5 UP html5up.net | @ajlkn Free for personal and commercial use under the CCA 3.0 license (html5up.net/license)

Credits:

Demo Images:
    Unsplash (unsplash.com)

Icons:
    Font Awesome (fontawesome.io)

Other:
    jQuery (jquery.com)
    Poptrox (github.com/ajlkn/jquery.poptrox)
    Responsive Tools (github.com/ajlkn/responsive-tools)