README.md

Python script that creates wallpaper with covers from personal top chart on Last.fm.

Dependencies

The script requires Python 3.10 or greater.

uv sync

Configuration

The first run of the script should end up with an error. Just follow the instructions in the error message to create new configuration file.

Create Wallpaper

By default, the script creates wallpaper with resolution 1920x1080 pixels.

The wallpaper will contain cover images of the top albums from personal weekly chart. If a cover image cannot be found, the album is skipped.

Change the wallpaper size:

uv run lastfm_wallpaper --size 3840x2160

Show albums (and other info) in the last generated wallpaper:

uv run lastfm_wallpaper --info

Use monthly album chart:

uv run lastfm_wallpaper --days 30

Show fewer covers (six in two rows):

uv run lastfm_wallpaper --rows 2 --count 6

Album chart from year ago:

uv run lastfm_wallpaper --days-ago 365

List available command line switches:

uv run lastfm_wallpaper --help

To avoid specifying the arguments repeatedly, you can set the options in configuration file (the default configuration file path is printed with --help). E.g. on Linux ~/.config/lastfm_wallpaper.ini can contain:

[default]
api_key = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
api_secret = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
user = lastfm_login
size = 3840x2160
days = 90
days-ago = 1
search = ~/Music/{artist} - {album}/cover.*