    ██╗     ██████╗ ██╗  ██╗██████╗ 
    ██║     ██╔══██╗╚██╗██╔╝██╔══██╗
    ██║     ██████╔╝ ╚███╔╝ ██║  ██║
    ██║     ██╔══██╗ ██╔██╗ ██║  ██║
    ███████╗██████╔╝██╔╝ ██╗██████╔╝
    ╚══════╝╚═════╝ ╚═╝  ╚═╝╚═════╝ 
        Letterboxd in your terminal

Features

Interactive TUI: Browse movie collections with a beautiful terminal interface
Recent Activity: View any user's movies, ratings, and reviews
Search: Find specific titles in user activity history
Movie Database: Search TMDB for detailed movie information
Export: Export user data to JSON or Markdown formats
Configuration: Persistent settings and user preferences
Caching: Offline access with intelligent data caching
Beautiful Display: Rich terminal output with ASCII art
Fast: Built in Rust for maximum performance and reliability

Installation

Prerequisites

Rust: Version 1.88.0 or later
Python 3: For Letterboxd data integration
Terminal: UTF-8 and ANSI color support recommended

Homebrew (Recommended)

macOS and Linux

brew tap pranav-karra-3301/lbxd
brew install lbxd

From Source

git clone https://github.com/Pranav-Karra-3301/lbxd.git
cd lbxd
cargo install --path .
pip3 install letterboxdpy

Dependencies

Python 3 with letterboxdpy package
curl for network requests
A modern terminal with Unicode support

Usage

Quick Start

lbxd
lbxd browse username
lbxd username

Commands

# Interactive Browsing
lbxd browse username

# Recent Activity
lbxd recent username
lbxd recent username --limit 10
lbxd recent username --rated
lbxd recent username --reviewed
lbxd recent username --date 2024-01-15

# Search
lbxd search username "blade runner"
lbxd movie "dune 2021"

# Data Export
lbxd export username --format json --output data.json
lbxd export username --format markdown --output report.md

# Configuration
lbxd config show
lbxd config set-user myusername
lbxd config whoami

Output Example

username Activity

  Blade Runner 2049 (2017)
  ★★★★★ (5.0/5)
  Liked
  A stunning sequel that honors the original while expanding the universe...
  January 15, 2024

  Dune (2021)
  ★★★★☆ (4.5/5)
  Villeneuve's adaptation is visually breathtaking...
  January 14, 2024

LLM Context

Copy and paste this into any LLM or coding tool for full context about lbxd:

lbxd
Rust License: MIT GitHub release

lbxd is a beautiful command-line tool written in Rust that brings Letterboxd to your terminal. View any user's activity, browse collections interactively, and explore movie data with rich terminal displays.

Features:
- Interactive TUI: Browse movie collections
- Recent Activity: View movies, ratings, reviews
- Search: Find titles in user activity
- Movie Database: Search TMDB
- Export: JSON/Markdown
- Config: Persistent settings
- Caching: Offline access
- Beautiful Display: ASCII art, colors
- Fast: Rust performance

Installation:
- Rust 1.88+, Python 3, modern terminal
- Homebrew: brew tap pranav-karra-3301/lbxd && brew install lbxd
- Source: git clone https://github.com/Pranav-Karra-3301/lbxd.git && cd lbxd && cargo install --path . && pip3 install letterboxdpy

Usage:
lbxd
lbxd browse username
lbxd recent username
lbxd search username "movie"
lbxd export username --format json --output data.json
lbxd config show

See full docs at: https://github.com/Pranav-Karra-3301/lbxd

MIT License. Developer: Pranav Karra (pranavkarra.me, letterboxd.com/pranavkarra)

Download llm.txt

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.