/pap

:pick: Pick a palette.

Primary LanguageShell

pap - pick a palette
--------------------

Easily change between your favorite palettes.

No randomness, no fuzz. Pick the palette you want to use, and enjoy the colors.

A small selection of palettes is included with pap, but you are encouraged to
extend the selection with your own personal favorites.

If you feel that your favorite palettes are worth sharing with the world, you
are more than welcome to open a PR to include them in pap's default selection.

Each palette defines the 16 ASCII colors in order and in hex format.

Each color's order represent:

Normal      Bright
------      ------
0 Black      8 Black
1 Red        9 Red
2 Yellow    10 Yellow
3 Green     11 Green
4 Blue      12 Blue
5 Magenta   13 Magenta
6 Cyan      14 Cyan
7 White     15 White


install
-------

Clone the repo.

    $ cd && git clone https://github.com/fehawen/pap.git

Change working directory to pap.

    $ cd pap

Install pap [*].

    $ make install

Add ~/.bin to PATH in $SHELL's startup file.

    export PATH=~/bin:$PATH

Specify a palette directory with PAP_DIR in $SHELL's startup file.

    export PAP_DIR=~/pap/palettes

Persist colors by adding the following in $SHELL's startup file.

    pap reload


[*] installs to ~/bin by default, and `make install` should thus not run as root.


usage
-----

pap u|use <palette>    Use selected palette
pap l|list             List available palettes
pap r|reload           Reload active palette (e.g. in $SHELL's startup file)