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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file letterboxd_stats-0.2.14.tar.gz.

File metadata

  • Download URL: letterboxd_stats-0.2.14.tar.gz
  • Upload date:
  • Size: 12.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for letterboxd_stats-0.2.14.tar.gz
Algorithm Hash digest
SHA256 7a0c6ab5d09236daccf35633d207a5a3168ef76f5c0b5b8e03b765edff29a542
MD5 d9f9a2ccdc35331ee3a98977f6d317ca
BLAKE2b-256 4c535ad4e97bc77a71ff2ca18121887b360f28059a771ba59d148a815ab73d53

See more details on using hashes here.

File details

Details for the file letterboxd_stats-0.2.14-py3-none-any.whl.

File metadata

File hashes

Hashes for letterboxd_stats-0.2.14-py3-none-any.whl
Algorithm Hash digest
SHA256 0d2283f69272e4532e30f0e9f3133db53413512e08b993880dce96ee14e7597f
MD5 fd7da40f46188ef25b237aa810396282
BLAKE2b-256 8d18f10aecde86f5b704ed6674965d010e86ddeb33b022b65cf0e6155625c5c3

See more details on using hashes here.

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