aboutsummaryrefslogtreecommitdiffstats
path: root/README.org
blob: 54bf46c404b3326396bbcec76a4a8ea484f88cbe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
#+title: Pick Random Wallpaper
#+options: toc:nil num:nil

A simple script that searches through any number of image files and picks one at random to set as the current wallpaper.

This script also tells [[https://herbstluftwm.org/][herbstluftwm]] what wallpaper it picked so that other scripts can work off of that.

* Requirements

This script requires [[https://scsh.net/][scsh]], [[https://www.gnu.org/software/findutils/][findutils]], [[https://www.x.org/wiki/][xwininfo]], [[https://feh.finalrewind.org/][feh]], and [[https://herbstluftwm.org/][herbstluftwm]].

* Installation

Put the =pick-random-wallpaper= script anywhere in your =$PATH=.

* Usage

Call the =pick-random-wallpaper= script without any arguments. It assumes that wallpapers are stored in =$HOME/pictures/wallpaper= under the resolution that they are for. It also looks at =$HOME/pictures/wallpaper/patterns/= for any tiled patterns. The hierarchy might look like:

: ~/pictures/wallpaper/
: |- 1024x768
: | \- a.jpg
: |- 5120x1440
: | |- b.png
: | \- sonic.jpg
: \- patterns
:   \- sandstone.png