QuickWall

Set any wallpaper from commandline


Keywords
cli, nitrogen, terminal, unsplash, wallpaper, wallpaper-setter
License
MIT
Install
pip install QuickWall==0.0.1.post2

Documentation

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.