lsused in BSD, FreeBSD and MacOS is slightly different. It uses a set or unset CLICOLOR environment variable or the
lscommand line switch -G to indicate whether to use the colours defined in the environment variable LSCOLORS. Whereas GNU’s
lsuses the command line switch −−colour and the environment variable LS_COLORS instead (Thanks Gilles). If you do not specify a colour to use then the default will be used, which is why unsetting LS_COLORS has no visible effect. The defaults can be obtained by running the dircolors command.
The database in question is a globally readable file which can be overridden depending on your terminal type. The database file is initially set to
/etc/DIR_COLORSthen overridden with one of the following. The first being the least precedent and the last being the most.
- COLOR - either tty (add colour to ls when output is on the command line), all (all colours to ls on the command line and when piping i.e.
ls > file.txtwill have colour coding information in it) and none (switch off).
- OPTIONS - strictly not related to LS_COLORS. This allows you to add extra options to the ls command.
- TERM - one line per terminal type that supports colour.
- EIGHTBIT - 1 (on) or 0 (off) to allow 8-bit output.
- and finally the colour definitions for file type and file extensions.
The LS_COLORS environment variable is a colon separated list of key=colour pairs. There are 2 types of key: file types and file extensions. Below is a list of all the keys (that I know of!). Thanks to Bartman for his starter page.
alias "ls=ls --color=auto"
|no||NORMAL, NORM||Global default, although everything should be something|
|ln||SYMLINK, LINK, LNK||Symbolic link. If you set this to ‘target’ instead of a numerical value, the color is as for the file pointed to.|
|pi||FIFO, PIPE||Named pipe|
|bd||BLOCK, BLK||Block device|
|cd||CHAR, CHR||Character device|
|or||ORPHAN||Symbolic link pointing to a non-existent file|
|su||SETUID||File that is setuid (u+s)|
|sg||SETGID||File that is setgid (g+s)|
|tw||STICKY_OTHER_WRITABLE||Directory that is sticky and other-writable (+t,o+w)|
|ow||OTHER_WRITABLE||Directory that is other-writable (o+w) and not sticky|
|st||STICKY||Directory with the sticky bit set (+t) and not other-writable|
|ex||EXEC||Executable file (i.e. has ‘x’ set in permissions)|
|mi||MISSING||Non-existent file pointed to by a symbolic link (visible when you type ls -l)|
|lc||LEFTCODE, LEFT||Opening terminal code|
|rc||RIGHTCODE, RIGHT||Closing terminal code|
|ec||ENDCODE, END||Non-filename text|
|*.extension||Every file using this extension e.g. *.jpg|
|100||Dark grey background|
|101||Light red background|
|102||Light green background|
|104||Light blue background|
|105||Light purple background|
The above snippet changes both directories colours to grey. Just as an aside, the easiest way to remap your colours is via the client control interface. I use PuTTY which allows you to redefine the terminal colour settings, but I think I’ll save that for another block entry!
LS_COLORS="ow=01;90:di=01;90" export LS_COLORS
Comment from: MightyBigCar [Visitor]
Well, it isn’t too secret. Try here:
I don’t think that your reference goes anywhere near describing how to do “Configuring LS_COLORS” but I’ll allow it in for two reasons: 1) the fact that anyone makes a comment is nice! 2) It’s another link to LS_COLORS which is a bit of a complicated affair, so the more links the better.
I know that I get about 400 page views (per month) of this article, but if I mention affair, will I get all the porn hunters looking here? Oh no, I’ve mentioned porn does that mean I’ll get even more? I’ll analyse the blog stats over the next couple of months and let you know… (in another blog!)
Comment from: ri [Visitor]
Comment from: Rita [Visitor]
Comment from: myname [Visitor]
97 - White (-:
Comment from: Wh1mpy [Visitor]
Comment from: peter [Visitor]
I’ve known and used ansi color sequences for a long time now, and this is the first reference to the ‘Extra colours’ that I’ve ever seen.
Sure enough, I tried them out and they all work! Awesome. (now I’m gonna waste a good chunk of time seeing how I can further customize all my syntax highlighting, LS_COLORS, zsh completion menu colors, etc etc…)
Where did you find out about these?
Comment from: Pete [Visitor]
Comment from: ed [Visitor]
Since your solution of : LS_COLORS="ow=01;90:di=01;90″ export LS_COLORS overwrites a possible existing configuration of LS_COLORS, you can juste substitute the existing definition with sed (stream editor) as follows :
echo $LS_COLORS |sed 's/di=[0-9]*;[0-9]*/di=01;34/; s/ow=[0-9]*;[0-9]*/ow=01;34/'”
Comment from: j tweed [Visitor]
You don’t make any mention of ~/.dir_colors or /etc/DIR_COLORS. At least the link provided by MightyBigCar does so, (and there is one in a comment)/ It seems to me that ~/.dir_colors is a convenient place to define colors.
Otherwise, a very useful tutorial. thanks.
Comment from: Rich [Visitor]
Seems like it boils down to this:
- dircolors –print-database > ~/.dircolors
- vi .dircolors
- update bashrc to look for ~/.dircolors (as per info page referenced in “man dircolors")
if [ -x /usr/bin/dircolors ]; then
d=.dircolors test -r $d && eval "$(dircolors $d)" || eval "`dircolors -b`"
Thanks for all the info.
Comment from: Peter Vanderhaden [Visitor]
Comment from: Rory [Visitor]
You could just look at the man page!
I have recently switched from BSD ls to GNU ls, and have been trying to perfect my LS_COLORS — this guide has been a godsend (one of many)…
A couple of things - you are missing at least two key - mh/MULTIHARDLINK for “Regular file[s] with more than one link” and ca/CAPABILITY for “File with capability.”
Also, and I haven’t seen this anywhere, if you’re feeling bold you can use the 256 colors of xterm instead of ANSI colors. You want to set the value of the key to the whole xterm escape sequence, as in \033[38;5;159. 38 there refers to foreground, 48 would be background. 159 is the color. Colors can be separated w/ the letter ‘m’, and ANSI escapes for underline, bold, flash, etc. can also be tacked on with an ‘m,’ as in \033[38;5;159m\e[04 (same as above, only underlined.)
I dread that the above will get eaten in the commenting process… :)
Comment from: mr black [Visitor]
Comment from: ChrisJ [Visitor]
Is there a simple way to turn off colors? (so that you see white letters on a black background and black letters on a white background). Putty defaults to a black background and xterm defaults to a white background.
In my opinion, blue-on-black and green-on-white are both ugly. : -)
Comment from: ChrisJ [Visitor]
Ok. I see now. To turn off colors use the unalias command. unalias ls ;
alias | egrep ls alias l.=’ls -d .* –color=tty’ alias ll=’ls -l –color=tty’ alias ls=’ls –color=tty’
It is ok to create new aliases that are not spelled the same as the standard commands. But I feel very strongly that you should never change the behaviour of an existing command such as ls. The last thing you want is to have your script changing behaviour (breaking) based on the configuration of the user running it.
This is a great guide. Thanks for writing it.
Comment from: Kirby Foster [Visitor]
Comment from: Curtis Rueden [Visitor]
Comment from: zss [Visitor]
Other than color names choice (ie 33 looks like yellow and 47 like white to me eyes), this is a fu*ing well done an dcomprehensive explanation on setting up LS_COLORS :)
Here’s how I set it up in ~/.bashrc (XDG compliant if it exists):
# Enable colors for ls, etc, prefering user's dircolors if type -P dircolors >/dev/null ; then if [[ -f "$XDG_HOME_CONFIG/bash/dircolors" ]] ; then eval $(dircolors -b "$XDG_HOME_CONFIG/bash/dircolors") elif [[ -f ~/.dircolors ]] ; then eval $(dircolors -b ~/.dircolors) elif [[ -f /etc/DIR_COLORS ]] ; then eval $(dircolors -b /etc/DIR_COLORS) fi fi
The following article emphasize on testing colors (nice tests) and setting usefull prompts thanks to your colors: *Bash tips: Colors and formatting* ( http://misc.flogisoft.com/bash/tip_colors_and_formatting )
Comment from: Kevin [Visitor]
if [ -x /usr/bin/dircolors ]; then test -r ~/.dircolors && eval "$(dircolors -b ~/.dircolors)" || eval "$(dircolors -b)"; alias ls='ls --color=auto'; fi
Thank you for this.
I had a problem with a bright green highlight showing for the background color of directories on an NTFS drive. Changing the line in .dir_colors from:
OTHER_WRITABLE 34;42 # dir that …
OTHER_WRITABLE 94;40 # dir …
made it more bearable.
Comment from: Pedro [Visitor]
Form is loading...