Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sharkdp/pastel
A command-line tool to generate, analyze, convert and manipulate colors
https://github.com/sharkdp/pastel
cli color-converter color-space colors command-line rust terminal tool
Last synced: 4 days ago
JSON representation
A command-line tool to generate, analyze, convert and manipulate colors
- Host: GitHub
- URL: https://github.com/sharkdp/pastel
- Owner: sharkdp
- License: apache-2.0
- Created: 2019-06-02T16:04:32.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-02T06:53:06.000Z (10 months ago)
- Last Synced: 2024-04-14T10:04:10.222Z (9 months ago)
- Topics: cli, color-converter, color-space, colors, command-line, rust, terminal, tool
- Language: Rust
- Homepage:
- Size: 9.12 MB
- Stars: 4,886
- Watchers: 24
- Forks: 95
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-tools - sharkdp/pastel - A command-line tool to generate, analyze, convert and manipulate colors (Command Line / Dependency Management)
- awesome-rust-tools - pastel - line tool to generate, analyze, convert and manipulate colors. (Dev-Utilities)
- awesome-starred-test - sharkdp/pastel - A command-line tool to generate, analyze, convert and manipulate colors (Rust)
- awesome-github-repos - sharkdp/pastel - A command-line tool to generate, analyze, convert and manipulate colors (Rust)
- awesome-devtools - Pastel - Manipulate and edit colors on the cli (Command line - Linux / Learning resources)
- awesome-list - pastel - line tool to generate, analyze, convert and manipulate colors | sharkdp | 3618 | (Rust)
- awesome-for-oneliner - pastel - A command-line tool to generate, convert and manipulate colors (Color / Open USP Tsukubai)
README
# pastel
[](https://github.com/sharkdp/pastel/actions)
[](https://github.com/sharkdp/pastel/releases)
[](https://crates.io/crates/pastel)
[](https://crates.io/crates/pastel)
`pastel` is a command-line tool to generate, analyze, convert and manipulate colors. It supports many different color formats and color spaces like RGB (sRGB), HSL, CIELAB, CIELCh as well as ANSI 8-bit and 24-bit representations.
## In action
## Tutorial
### Getting help
`pastel` provides a number of commands like `saturate`, `mix` or `paint`. To see a complete list, you can simply run
``` bash
pastel
```
To get more information about a specific subcommand (say `mix`), you can call `pastel mix -h` or `pastel help mix`.
### Composition
Many `pastel` commands can be composed by piping the output of one command to another, for example:
``` bash
pastel random | pastel mix red | pastel lighten 0.2 | pastel format hex
```
### Specifying colors
Colors can be specified in many different formats:
```
lightslategray
'#778899'
778899
789
'rgb(119, 136, 153)'
'119,136,153'
'hsl(210, 14.3%, 53.3%)'
```
Colors can be passed as positional arguments, for example:
```
pastel lighten 0.2 orchid orange lawngreen
```
They can also be read from standard input. So this is equivalent:
```
printf "%s\n" orchid orange lawngreen | pastel lighten 0.2
```
You can also explicitly specify which colors you want to read from the input. For example, this mixes `red` (which is read from STDIN) with `blue` (which is passed on the command line):
```
pastel color red | pastel mix - blue
```
### Use cases and demo
#### Converting colors from one format to another
``` bash
pastel format hsl ff8000
```
#### Show and analyze colors on the terminal
``` bash
pastel color "rgb(255,50,127)"
pastel color 556270 4ecdc4 c7f484 ff6b6b c44d58
```
#### Pick a color from somewhere on the screen
``` bash
pastel pick
```
#### Generate a set of N visually distinct colors
```
pastel distinct 8
```
#### Get a list of all X11 / CSS color names
``` bash
pastel list
```
#### Name a given color
``` bash
pastel format name 44cc11
```
#### Print colorized text from a shell script
``` bash
bg="hotpink"
fg="$(pastel textcolor "$bg")"
pastel paint "$fg" --on "$bg" "well readable text"
```
``` bash
pastel paint -n black --on red --bold " ERROR! "
echo " A serious error"
pastel paint -n black --on yellow --bold " WARNING! "
echo " A warning message"
pastel paint -n black --on limegreen --bold " INFO "
echo -n " Informational message with a "
echo -n "highlighted" | pastel paint -n default --underline
echo " word"
```
## Installation
### On Debian-based systems
You can download the latest Debian package from the [release page](https://github.com/sharkdp/pastel/releases) and install it via `dpkg`:
``` bash
wget "https://github.com/sharkdp/pastel/releases/download/v0.8.1/pastel_0.8.1_amd64.deb"
sudo dpkg -i pastel_0.8.1_amd64.deb
```
### On Arch Linux
You can install `pastel` from the [Extra](https://archlinux.org/packages/extra/x86_64/pastel/) repositories:
```
sudo pacman -S pastel
```
### On Nix
You can install `pastel` from the [Nix package](https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/misc/pastel/default.nix):
```
nix-env --install pastel
```
### On MacOS
You can install `pastel` via [Homebrew](https://formulae.brew.sh/formula/pastel)
```
brew install pastel
```
### On Windows
You can install `pastel` via [Scoop](https://github.com/ScoopInstaller/Main/blob/master/bucket/pastel.json)
```
scoop install pastel
```
#### With Winget
You can install `pastel` via [Winget](https://learn.microsoft.com/en-us/windows/package-manager/):
```bash
winget install sharkdp.pastel
```
### Via snap package
[Get it from the Snap Store](https://snapcraft.io/pastel):
```
sudo snap install pastel
```
### On NetBSD
Using the package manager:
```
pkgin install pastel
```
From source:
```
cd /usr/pkgsrc/graphics/pastel
make install
```
### On other distributions
Check out the [release page](https://github.com/sharkdp/pastel/releases) for binary builds.
### Via cargo (source)
If you do not have cargo, install using [rust's installation documentation](https://doc.rust-lang.org/book/ch01-01-installation.html).
If you have Rust 1.43 or higher, you can install `pastel` from source via `cargo`:
```
cargo install pastel
```
Alternatively, you can install `pastel` directly from this repository by using
```
git clone https://github.com/sharkdp/pastel
cargo install --path ./pastel
```
## Resources
Interesting Wikipedia pages:
* [Color difference](https://en.wikipedia.org/wiki/Color_difference)
* [CIE 1931 color space](https://en.wikipedia.org/wiki/CIE_1931_color_space)
* [CIELAB color space](https://en.wikipedia.org/wiki/CIELAB_color_space)
* [Line of purples](https://en.wikipedia.org/wiki/Line_of_purples)
* [Impossible color](https://en.wikipedia.org/wiki/Impossible_color)
* [sRGB](https://en.wikipedia.org/wiki/SRGB)
* [Color theory](https://en.wikipedia.org/wiki/Color_theory)
* [Eigengrau](https://en.wikipedia.org/wiki/Eigengrau)
Color names:
* [XKCD Color Survey Results](https://blog.xkcd.com/2010/05/03/color-survey-results/)
* [Peachpuffs and Lemonchiffons - talk about named colors](https://www.youtube.com/watch?v=HmStJQzclHc)
* [List of CSS color keywords](https://www.w3.org/TR/SVG11/types.html#ColorKeywords)
Maximally distinct colors:
* [How to automatically generate N "distinct" colors?](https://stackoverflow.com/q/470690/704831)
* [Publication on two algorithms to generate (maximally) distinct colors](http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.65.2790)
Other articles and videos:
* [Color Matching](https://www.youtube.com/watch?v=82ItpxqPP4I)
* [Introduction to color spaces](https://ciechanow.ski/color-spaces/)
## License
Licensed under either of
* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.