diff options
author | Vasil Zlatanov <vasil.zlatanov@gmail.com> | 2015-04-12 13:05:47 +0200 |
---|---|---|
committer | Vasil Zlatanov <vasil.zlatanov@gmail.com> | 2015-04-12 13:05:47 +0200 |
commit | 47a0a3f433f820fc78d180884f6ca376fba97b73 (patch) | |
tree | 587b80062ebdb947d26ca7a70e32b38b7d67ca45 /tools/README.md | |
parent | 269e617fea39658233db38ad503030c4fe040e80 (diff) | |
download | dotfiles-47a0a3f433f820fc78d180884f6ca376fba97b73.tar.gz dotfiles-47a0a3f433f820fc78d180884f6ca376fba97b73.tar.bz2 dotfiles-47a0a3f433f820fc78d180884f6ca376fba97b73.zip |
Tidy up everything :)
Diffstat (limited to 'tools/README.md')
-rw-r--r-- | tools/README.md | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/tools/README.md b/tools/README.md new file mode 100644 index 0000000..6970672 --- /dev/null +++ b/tools/README.md @@ -0,0 +1,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. |