qui

QuickWall

Set latest wallpapers from Unsplash from the commandline

Showing:

Popularity

Downloads/wk

0

GitHub Stars

137

Maintenance

Last Commit

9mos ago

Contributors

4

Package

Dependencies

5

License

MIT

Categories

Readme

QuickWall


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

forthebadge made-with-python

Travis (.org) License PyPI PyPI - Downloads PRs Welcome

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

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]
                 [--remove-id ID] [--dir DIR] [--id ID] [--random]
                 [--search TERM] [--migrate] [--set-lockscreen]

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
                        (~/.cache/QuickWall)
  --setter SETTER       Wallpaper setter to be used. Currently supported
                        ones: nitrogen, feh, xfce, kde, gnome, unity
                        (default: nitrogen)
  -d, --disable-blacklist
                        Disable adding the image to blacklisted ones.
  --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)

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

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100