Python script for generating wallpapers from data
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Build Status Coverage Status

Python script for generating wallpapers from data.

Copyright (C) 2014 Alex Phillips (Email:

./ will display the instructions.

Please try to use the local option '-l' when possible to be kind to's servers.


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

See for more information

Changes to original script

  • Background Color (--BackgroundColor)
  • Image Type (--ImageType)
  • Use artist images instead of album covers (--Artist)
  • Rounding of image corners (--Radius)
  • Adapted for Python 3
  • Updated for API 2.0


  • Tested on Python 2.6, 2.7, 3.2 or 3.3
  • Python Imaging Library (not available for Python 3; 'Pillow' is a drop-in replacement)
  • A account and an active internet connection
  • API account (available for free [here] 7)


pip install -r requirements.txt

Album of Examples:

[Imgur] 8 - each captioned with the options required to generate that example.

v. 16 Jul 2013

  • Consolidated [Roignac] 5 and [HelgeBS] 3's changes into one script
  • Integer division no longer truncates as of Python 3.0, instead returning a float. Changed all instances of '/' used for integer division to '//', the floor division operator to better preserve functionality.
  • Lots of formatting to try to conform to the Python Style Guide

v. 19 Jul 2013

  • Updated for API 2.0 (user can use their own API account)
  • Fixed artist option

v. 08 Feb 2014

  • Fixed gradient on albums in Collage not being applied on left and right borders.


Thanks to [Koant] 1 for his [original script] 2 and to [HelgeBS] 3 for the addition of the background color and image type [options] 4, and to [Roignac] 5 for the artist image and rounded corners [options] 6.