Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


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.


Python script for generating wallpapers from data




No releases published


No packages published