README.md


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
42

# pywal (A `wal` rewrite in Python 3)

[![PyPI](https://img.shields.io/pypi/v/pywal.svg)](https://pypi.python.org/pypi/pywal/) [![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE.md) [![Build Status](https://travis-ci.org/dylanaraps/pywal.svg?branch=master)](https://travis-ci.org/dylanaraps/pywal)


`wal` is a script that takes an image (or a directory of images), generates a colorscheme (using `imagemagick`) and then changes all of your open terminal's colors to the new colorscheme on the fly. `wal` then caches each generated colorscheme so that cycling through wallpapers while changing colorschemes is instantaneous.

`wal` also merges the new colorscheme into the Xresources database so that programs on your system such as `Rofi` or `i3` use the new colors automatically. `wal` finally exports the colors into various formats so that you can use the colors in webpages, scripts, other programs etc.

For more info, check out the [Wiki](https://github.com/dylanaraps/pywal/wiki).

**NOTE:** `wal` is not perfect and won't work well with some images.


[Albums of examples (Warning large)](https://dylanaraps.com/pages/rice)

![screenshot](https://i.imgur.com/hkAJjJg.png)


## Table of Contents

<!-- vim-markdown-toc GFM -->
* [Installation](#installation)
* [Getting Started](#getting-started)
* [Customization](#customization)

<!-- vim-markdown-toc -->


## Installation

https://github.com/dylanaraps/pywal/wiki/Installation


## Getting Started

https://github.com/dylanaraps/pywal/wiki/Getting-Started


## Customization

https://github.com/dylanaraps/pywal/wiki