Skip to content
Set latest wallpapers from Unsplash from the commandline
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
QuickWall Added dir option Aug 14, 2019
scripts Added dir option Aug 14, 2019
.gitignore Added blacklist feature Aug 13, 2019
LICENSE Added LICENSE Aug 12, 2019 Added dir option Aug 14, 2019 Python requirement bumped up to 3.6+ Aug 14, 2019
qw.gif repo init Aug 12, 2019 Added dir option Aug 14, 2019


  1. How It Works
  2. Requirements
  3. Installation
  4. Usage
  5. TODO
  6. Acknowledgements

How It Works

It uses Unsplash API to get wallpapers and set them using nitrogen.

The images are downloaded to ~/.QuickWall/ and then set by nitrogen.


  1. Python 3.6+

  2. Currently supported wallpaper setters

NOTE: These dependencies in linux can be installed in other variants.
For arch linux, you can use pacman package manager accordingly.


  • It is available in Pypi
pip3 install QuickWall


  • Run the following command in the root directory to install QuickWall.
python install

NOTE: If you get permission denied error, run the above command with sudo.


usage: QuickWall [-h] [--version] [--clear-cache] [--setter SETTER]
                 [--dir DIR]

QuickWall - Quickly set latest wallpapers from Unsplash directly from the

optional arguments:
  -h, --help       show this help message and exit
  --version        show the program version number and exit
  --clear-cache    Clear the cache from the cache folder (~/.QuickWall)
  --setter SETTER  Wallpaper setter to be used. Currently supported ones:
                   nitrogen, feh (default: nitrogen)
  --dir DIR        Directory to download the wallpapers


  • Add a logger
  • Add support for different wallpaper setters (raise an issue if you want me to support some particular one)
  • Handle errors better


Unsplash for their awesome API.

You can’t perform that action at this time.