Skip to content
Set latest wallpapers from Unsplash from the commandline
Python
Branch: master
Clone or download
Permalink
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
QuickWall.py Added dir option Aug 14, 2019
README.md Python requirement bumped up to 3.6+ Aug 14, 2019
qw.gif repo init Aug 12, 2019
setup.py Added dir option Aug 14, 2019

README.md

QuickWall

  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.

Requirements

  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.

Installation

  • It is available in Pypi
pip3 install QuickWall

OR

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

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

Usage


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

QuickWall - Quickly set latest wallpapers from Unsplash directly from the
commandline.

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


TODO

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

Acknowledgements

Unsplash for their awesome API.

You can’t perform that action at this time.