Skip to content
/ wgs Public

A minimal wallpaper getter setter

License

Notifications You must be signed in to change notification settings

wick3dr0se/wgs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 

Repository files navigation

wgs - wallpaper getter setter

Written in pure BASH, wgs is minimal, fast and requires no external dependencies outside of your supported wallpaper setter choice. wgs utilizes Unsplash's API to return random images based on optional queries. wgs can repeatedly download and set images, with common wallpaper setters, on a set interval. It can also be pushed to the background and disowned from the terminal (see below) to keep wgs alive, even upon closing the window

Install

Download the repository

git clone https://github.com/wick3dr0se/wgs&& cd wgs

Arguments

-a[:interval]  ...  repeatedley get/set wallpapers per interval
-o<:file_name>  ...  set wallpaper name to file name

Legend
[] - optional option
<> - required argument
# - comment

Usage

Download and set a completely random image to wallpaper

bash wgs.sh

Name image output

bash wgs.sh -o<:wallpaper_name>

Download and set a random image based on quer{y,ies}

bash wgs.sh <query> [query]

Continuously download and set images

bash -a[:interval] [query]

interval will fallback to 30 seconds when -a is supplied without :N seconds

Cotinuously download and set images in the background

bash -a[:interval] [query] & disown
# if you run it more than once, make sure to kill the previous process, otherwise they will stack