Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thevinter/styli.sh
A CLI tool for easy wallpaper management and image fetching
https://github.com/thevinter/styli.sh
Last synced: 3 months ago
JSON representation
A CLI tool for easy wallpaper management and image fetching
- Host: GitHub
- URL: https://github.com/thevinter/styli.sh
- Owner: thevinter
- License: mit
- Created: 2021-06-03T12:14:05.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-03-20T10:26:41.000Z (8 months ago)
- Last Synced: 2024-05-12T16:32:32.220Z (6 months ago)
- Language: Shell
- Size: 4.71 MB
- Stars: 393
- Watchers: 4
- Forks: 35
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-browserless - styli.sh - A CLI tool for easy wallpaper management and image fetching (Viewing images)
README
# 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.
## 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
$ ./styli.sh -r wallpaperdump
# To use the builtin feh --bg options
$ ./styli.sh -b
$ ./styli.sh -b bg-scale -r widescreen-wallpaper
# To add custom feh flags
$ ./styli.sh -c
$ ./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
# 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`