Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ramnes/context-color
:rainbow: To each context its own shell color
https://github.com/ramnes/context-color
posix-compliant shell terminal unixporn
Last synced: 20 days ago
JSON representation
:rainbow: To each context its own shell color
- Host: GitHub
- URL: https://github.com/ramnes/context-color
- Owner: ramnes
- License: gpl-3.0
- Created: 2018-01-15T18:01:58.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-05-14T12:25:39.000Z (6 months ago)
- Last Synced: 2024-10-13T11:24:40.211Z (about 1 month ago)
- Topics: posix-compliant, shell, terminal, unixporn
- Language: Shell
- Size: 98.6 KB
- Stars: 129
- Watchers: 7
- Forks: 11
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
context-color
=============
[](https://github.com/ramnes/context-color/actions)
:rainbow: To each context its own shell color
`context-color` is a simple script that, when executed, outputs a color based
on a command output's hash.
Example
-------
Once installed somewhere in your `$PATH`, it allows you to do things like this:
```bash
PS1="$(context-color -p)$PS1\[\e[0m\]"
```
(where `--prompt/-p` is the switch so that the color is escaped for prompts,
and `\[\e[0m\]` the escape sequence to reset color)
If your prompt does not use colors already, this example would customize it so
that its color changes according to the current context.
The default context command (i.e. the command that is used to generate the
hash) is `whoami; hostname`. If you would just want the color to change
according to the hostname, you would change the `CC_CONTEXT` environment
variable (`export CC_CONTEXT="hostname"`) or simply use the `--context/-c`
option (`context-color -c "hostname"`).
Then you could make this customization permanent by adding this line to your
`~/.bashrc`, or to the system-wide `bashrc` file (most likely somewhere in
`/etc/`, depending on your distribution) if you would want all users to benefit
from this.
If you are working with several machines, you could either do that manipulation
on every host, or use something like
[Russell91/xxh](https://github.com/xxh/xxh).
> :warning: Do not use single quotes around your `PS1` value. If you want the
> color to be evaluated at each prompt, you should use `PROMPT_COMMAND`
> instead. Here is an example:
>
> ```bash
> PS1="$PS1\[\e[0m\]"
> PROMPT_COMMAND="context-color"
> ```
Install
-------
Something in those lines should do it:
```bash
cd .local/bin/
wget https://raw.githubusercontent.com/ramnes/context-color/master/context-color
chmod a+x context-color
```
This snippet assumes that `~/.local/bin/` is in your `$PATH` environment
variable. If it is not, you can either put `context-color` somewhere else
(`/usr/local/bin/`, for example), or insert `~/.local/bin/` into your `$PATH`,
by adding this line into your bash configuration:
```bash
export PATH="~/.local/bin/:$PATH"
```
Usage
-----
```
usage: context-color [OPTIONS]
Print a color sequence based on a command output's hash.
COMMON OPTIONS:
--help, -h Print this help.
--background, -b Use a background sequence rather than foreground.
--id, -i Print the color id rather than the color sequence.
--prompt, -p Declare the sequence as non-printable for prompts.
--context , -c
Define the context command on which result the color
will be generated.
The default context is "whoami; hostname".
--exclude , -e
Comma separated list of color ids not to be used.
Multiple --exclude/-e arguments can be specified.
The default excluded colors are: "0,7,15"
--method , -m
Choose which hashing method to use. "sum" will tend to
give adjacent colors for adjacent context outputs.
"md5sum" will give more randomization on colors.
The default method is: "sum"
DEBUG OPTIONS:
--debug, -d Output the sequence as a human-readable string and more
useful information.
--force , -f
Ignore the context and force a color id instead.
```
The `-p` option must be used if you use `context-color` inside a prompt. It
makes your shell understand that the color sequence characters won't be used
when it's trying to guess the space left on the current line. See issue
[#8](https://github.com/ramnes/context-color/issues/8) for a good description
of what happens if you do not put `-p` in that situation.
Credits
-------
The original implementation was based on *J Earls* answer on
[this SuperUser question](https://superuser.com/questions/1123671).
He's the real MVP. :ok_hand:
License
-------
GNU GPL v3