QuickWall

How It Works   |   Installation   |   Requirements   |   Usage   |   TODO   |   Acknowledgements   

How It Works

It detects your DE or WM, gets wallpapers from Unsplash and sets them using either your choice of wallpaper setter or by nitrogen. Not enough? It can also change your theme based on the wallpapers that it gets, thanks to pywal.

Installation

• It is available in Pypi

pip3 install QuickWall

• Available in AUR here

yay -S quickwall

NOTE: The directory is changed from ~/.QuickWall to ~/.cache/QuickWall. Early users can use --migrate option to move their data.

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.

Requirements

1. Python 3.6+

2. Currently supported wallpaper setters

   • nitrogen
   • feh
   • kde
   • xfce
   • gnome/unity

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

Usage

usage: quickwall [-h] [--version] [--clear-cache] [--setter SETTER] [-d] [-t]
                 [--remove-id ID] [--dir DIR] [--id ID] [--random]
                 [--search TERM] [--migrate] [--set-lockscreen]
                 [--level LEVEL] [--list-level]

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

options:
  -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
                        (~/.cache/QuickWall)
  --setter SETTER       Wallpaper setter to be used. Currently supported ones:
                        nitrogen, feh, xfce, kde, gnome, unity (default: auto)
  -d, --disable-blacklist
                        Disable adding the image to blacklisted ones.
  -t, --disable-theme   Disable setting a colorscheme extracted from the
                        wallpaper
  --remove-id ID        Remove the passed ID from the blacklist.
  --dir DIR             Directory to download the wallpapers
  --id ID               Get a photo by its ID.
  --random              Get random wallpapers.
  --search TERM         Show wallpapers based on the passed term
  --migrate             ONLY FOR EARLY USERS. Move the files from ~/.QuickWall
                        to ~/.cache/QuickWall.
  --set-lockscreen      Set lockscreen wallpaper (currently for KDE)

Logger:
  --level LEVEL         The level of the logger that will be used while
                        verbosing. Use `--list-level` to check available
                        options.
  --list-level          List all the available logger levels.

TODO

• Add tests
• Add support for different wallpaper setters (raise an issue if you want me to support some particular one)
• Handle errors better
• Add support for GNOME/Unity
• Add support for XFCE
• Add automatic detection of wallpaper setter depending on the OS. Fallback would be nitrogen.
• Add support to restore wallpapers for KDE.
• Add a logger
• Add support to search

Acknowledgements

• Unsplash for their awesome API.
• Pavel Borisov for ksetpaper code.