Skip to content

A CLI tool for easy wallpaper management and image fetching

License

Notifications You must be signed in to change notification settings

thevinter/styli.sh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Styli.sh - Wallpaper switching made easy

Styli.sh is a Bash script that aims to automate the tedious process of finding new wallpapers, downloading and switching them via the configs. Styli.sh can search for specific wallpapers from unsplash or download a random image from the specified subreddits. If you have pywal it also can set automatically your terminal colors.

Preview

Requirements

This script is made to work with feh, nitrogen, XFCE, GNOME, KDE or Sway, having one of those is a requirement.```

Install

git clone https://github.com/thevinter/styli.sh
cd styli.sh
./styli.sh

Usage

# To set a random 1920x1080 background
$ ./styli.sh

# Save the current image to ~/Pictures directory
$ ./styli.sh -sa

# To specify a desired width or height
$ ./styli.sh -w 1080 -h 720
$ ./styli.sh -w 2560
$ ./styli.sh -h 1440

# To set a wallpaper based on a search term
$ ./styli.sh -s island
$ ./styli.sh -s "sea sunset"
$ ./styli.sh -s sea -w 1080

# To get a random wallpaper from one of the set subreddits
# NOTE: The width/height/search parameters DON'T work with reddit
$ ./styli.sh -l reddit

# To get a random wallpaper from a custom subreddit
$ ./styli.sh -r <custom_reddit>
$ ./styli.sh -r wallpaperdump

# To use the builtin feh --bg options
$ ./styli.sh -b <option>
$ ./styli.sh -b bg-scale -r widescreen-wallpaper

# To add custom feh flags
$ ./styli.sh -c <flags>
$ ./styli.sh -c --no-xinerama -r widescreen-wallpaper

# To automatically set the terminal colors
$ ./styli.sh -p

# To use nitrogen instead of feh
$ ./styli.sh -n

# To update > 1 screens using nitrogen
$ ./styli.sh -n -m <number_of_screens>

# Choose a random background from a directory
$ ./styli.sh -d /path/to/dir

KDE, GNOME, XFCE & Sway

KDE, GNOME, XFCE and Sway are natively supported without the need of feh. The script currently does not allow to scale the image. To use their built-in background managers use the appropriate flag.

# GNOME
$ ./styli.sh -g

# XFCE
$ ./styli.sh -x

# KDE
$ ./styli.sh -k


# Hyprpaper (Hyprland)
$ ./styli.sh -hp

# Sway
$ ./styli.sh -y

Tips And Tricks

To set a new background every time you reboot your computer add the following to your i3/config file (or any other WM config)

exec_always path/to/script/styli.sh

To change background every hour launch the following command

crontab -e

and add the following to the opened file

@hourly path/to/script/styli.sh

Custom subreddits

To manage custom subreddits just edit the subreddits file by placing there all your desired communities, one for each newline

TODO

  • Cinnamon support
  • Remove the need for flags by reading $DESKTOP_SESSION

About

A CLI tool for easy wallpaper management and image fetching

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages