Skip to content

Latest commit

 

History

History
43 lines (29 loc) · 1.85 KB

README.md

File metadata and controls

43 lines (29 loc) · 1.85 KB

farrago

farrago generates customized album art collages, using listening data from last.fm and bandcamp.

Faero  830x200  39 tiles  13x3

Collages can be generated for any aspect ratio, and in any resolution.

Some suggested usages are:

  • Desktop background
  • A printed poster of any size, portrait or landscape
  • Phone background
  • A banner or column for your website

Usage

You must edit collage.py and fill in a last.fm API key and shared secret.

python collage.py --lastfm-username <username> --bandcamp-username <username> --width 3840 --height 1600

Use the --width and --height parameters to specify your required image resolution. You can also use --max-covers to limit how many covers are used - resulting in larger tiles.

Examples

Poster-sized images are over 50MB, hence no examples are provided here.

Printing a poster

If you want to generate a suitable resolution image for a professionally printed poster, use these resolution guidelines:

  • 150dpi A0 - 7021 x 4967
  • 300dpi A0 - 14043 x 9933
  • 600dpi A0 - 28086 x 19866

Implementation

The first run will be slow, as profile/image needs to be fetched from last.fm and bandcamp especially if you try to generate a high resolution image. Subsequent runs will be much faster, as last.fm data and images will be cached from the previous attempt. Bandcamp data is not yet cached, and will be fetched every time.