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


Installation
------------

Clone the repo.

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

Change working directory to pap.

    $ cd pap

Install pap.

    $ make install

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


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)


caveats
-------

Make sure that your terminal emulator has proper OSC implementation.
For example, st terminal doesn't play nicely with pap without the osc patch:

https://st.suckless.org/patches/osc_10_11_12_2/