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
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7a0c6ab5d09236daccf35633d207a5a3168ef76f5c0b5b8e03b765edff29a542 |
|
MD5 | d9f9a2ccdc35331ee3a98977f6d317ca |
|
BLAKE2b-256 | 4c535ad4e97bc77a71ff2ca18121887b360f28059a771ba59d148a815ab73d53 |
File details
Details for the file letterboxd_stats-0.2.14-py3-none-any.whl
.
File metadata
- Download URL: letterboxd_stats-0.2.14-py3-none-any.whl
- Upload date:
- Size: 13.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0d2283f69272e4532e30f0e9f3133db53413512e08b993880dce96ee14e7597f |
|
MD5 | fd7da40f46188ef25b237aa810396282 |
|
BLAKE2b-256 | 8d18f10aecde86f5b704ed6674965d010e86ddeb33b022b65cf0e6155625c5c3 |