Skip to main content

Get information about your Letterboxd activity.

Project description

Letterboxd Stats

Get information about your Letterboxd activity.

Search for actors/directors, analyze your diary/watchlist/rating, check which film you have seen for a particular person. All in your terminal.

Requirements

  • Python >= 3.8
  • A TMDb API key: to retrieve all the general information for movies/people
  • A Letterboxd account: to export your Letterboxd activity through web-scraping.

Installation

Just run:

pip3 install letterboxd_stats

Configuration

It is required to create a config.toml. You can create it in the default config folder (for example, .config/letterboxd_stats in Linux) or specify your custom folder with the -c command. For each platform, default config folder follows the structure of the platformdirs package.

# Where you want the .csv file of your Letterboxd activity to be saved.
root_folder = "~/Documents/letterboxd_stats/"

[CLI]
# The size of the ASCII art poster printed in your terminal when you check the details of a movie.
# Set to 0 to disable
poster_columns = 180
# Set ascending order for sorting of tables
ascending = false

[TMDB]
api_key = "YOUR_TMDB_API_KEY"
# When you get your lists (-L options), also get all the runtimes from TMDB
# and compute the mean of the ratings weigthed on the durations. This slows the process.
get_list_runtimes = false


[Letterboxd]
username = "your-username"
password = "your-password"

Options

options:
  -h, --help            show this help message and exit
  -s SEARCH, --search SEARCH
                        Search for a director
  -S SEARCH_FILM, --search-film SEARCH_FILM
                        Search for a film.
  -d, --download        Download letterboxd data from your account
  -W, --watchlist       show watchlist
  -D, --diary           show diary
  -R, --ratings         show ratings
  -L, --lists           show lists
  -l LIMIT, --limit LIMIT
                        limit the number of items of your wishlist/diary
  -c CONFIG_FOLDER, --config_folder CONFIG_FOLDER
                        Specifiy the folder of your config.toml file

To do

Note: this is something I do during my free time. Therefore, I can't promise consistent support for this project.

  • Use web-scraping to add film to diary/wishlist

  • Check followers' activity.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

letterboxd_stats-0.2.14.tar.gz (12.9 kB view hashes)

Uploaded Source

Built Distribution

letterboxd_stats-0.2.14-py3-none-any.whl (13.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page