aboutsummaryrefslogtreecommitdiff
path: root/config/ratpoison/README.md
blob: 697067235a9dd6bb73e320b959f8f25758896bfe (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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# wp

wp is a small tool I use to generate color schemes from images, and manage desktop wallpapers.

The color extraction scripts were taken from [this blog post](http://charlesleifer.com/blog/using-python-and-k-means-to-find-the-dominant-colors-in-images/)
 with normalization reddit user radiosilence.

## Dependencies

As far as I know this only relies on PIL, python image library. I was able to fulfill this dependency with the `python-pillow` package on Arch Linux.
On other systems, `pip install Pillow`.

## Usage

```
$ wp add [file]
```

Generates color files .[file].colors and .[file].Xres which can be sourced by shell
scripts and xrdb respectivly. The color files and the image are added to the backgrounds directory.

```
$ wp change [file]
```

Changes the background image to a random image from the ~/.wallpapers directory, or the file passed, and  loads the .Xres file
into xrdb so xterm or urxvt will use the colors. It also links a script to ~/.colors. If you `source ~/.colors` in a script 
you can use the generated colors with `$COLOR0`, `$COLOR1`, ...


```
$ wp rm [file]
```

Removes the image and it's color files from the backgrounds directory.

```
$ wp ls
```

Lists the images in the backgrounds folder.