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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for letterboxd_stats-0.2.14-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0d2283f69272e4532e30f0e9f3133db53413512e08b993880dce96ee14e7597f |
|
MD5 | fd7da40f46188ef25b237aa810396282 |
|
BLAKE2b-256 | 8d18f10aecde86f5b704ed6674965d010e86ddeb33b022b65cf0e6155625c5c3 |