mirror of
https://github.com/trapd00r/LS_COLORS.git
synced 2024-12-22 13:52:12 +01:00
95 lines
3 KiB
Markdown
95 lines
3 KiB
Markdown
# LS_COLORS
|
|
|
|
This is a collection of extension:color mappings, suitable to use as your
|
|
`LS COLORS` environment variable. Most of them use the extended color map,
|
|
described in the ECMA-48 document; in other words, you'll need a terminal
|
|
with capabilities of displaying 256 colors.
|
|
|
|
As of this writing, around 300 different filetypes/extensions is supported.
|
|
That's indeed a lot of extensions, but there's a lot more! Your help is greatly
|
|
appreciated.
|
|
|
|
Fork this project on github, add the extensions you are missing, and send a pull
|
|
request.
|
|
|
|
Some guidelines:
|
|
|
|
For files that usually ends up next to each other, like html, css and js,
|
|
try to pick colors that fits in nicely together. Filetypes with multiple
|
|
possible extensions, like htm and html, should have the same color.
|
|
|
|
# Installation
|
|
To install and use this file, put something like this is your shell resource
|
|
file:
|
|
```
|
|
eval $( dircolors -b $HOME/LS_COLORS )
|
|
```
|
|
|
|
A quick way to install would be the following set of commands (assuming bash):
|
|
|
|
```sh
|
|
wget https://raw.github.com/trapd00r/LS_COLORS/master/LS_COLORS -O $HOME/.dircolors
|
|
echo 'eval $(dircolors -b $HOME/.dircolors)' >> $HOME/.bashrc
|
|
. $HOME/.bashrc
|
|
```
|
|
|
|
## For fish shell
|
|
|
|
```
|
|
eval ( dircolors --c-shell $HOME/LS_COLORS )
|
|
```
|
|
|
|
Place it in `~/.config/fish/config.fish` or any `*.fish*` file inside `~/.config/fish/conf.d/` to be loaded.
|
|
|
|
## Archlinux
|
|
Archlinux users can install the [`lscolors-git`][3] package from the AUR for easy
|
|
integration with bash, csh, or zsh.
|
|
|
|
## ZSH Syntax highlighting
|
|
|
|
[zsh-syntax-highlighting-filetypes][0] highlights file on the command-line in
|
|
realtime, using these colors.
|
|
|
|
# Information for Developers
|
|
|
|
There's a [library][1] I've written that lets you use various LS COLORS on
|
|
arbitrary files and directories. A simple implementation can be found [here][2].
|
|
|
|
Using this, you can do
|
|
|
|
find $HOME -maxdepth 1 | ls_color
|
|
|
|
mpc search artist Laleh | ls_color
|
|
|
|
... and so on.
|
|
|
|
# How does it look like
|
|
|
|
Here's a screenshot:
|
|
|
|
|
|
|
|
And another one:
|
|
|
|
|
|
|
|
|
|
[0]: https://github.com/trapd00r/zsh-syntax-highlighting-filetypes
|
|
[1]: https://github.com/trapd00r/File-LsColor
|
|
[2]: https://github.com/trapd00r/File-LsColor/tree/master/bin
|
|
[3]: https://aur.archlinux.org/packages/lscolors-git
|
|
|
|
# Legal
|
|
|
|
© Copyright 2014-2018 Magnus Woldrich.
|
|
|
|
This program is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
|
PARTICULAR PURPOSE. See the Perl Artistic License for more details.
|
|
|
|
This program is free software: you can redistribute it and/or modify it under
|
|
the terms of the Perl Artistic License as published by the Perl Foundation,
|
|
either version 1.0 of the License, or (at your option) any later version.
|
|
|
|
You should have received a copy of the Perl Artistic License along
|
|
with this program. If not, see <http://www.perlfoundation.org/artistic_license_1_0>.
|