From Fedora Project Wiki
No edit summary
Line 121: Line 121:


== Dependencies / Affected packages ==
== Dependencies / Affected packages ==
The following packages should be updated in order to enable or improve the 256 colors usage:
The following packages could be updated in order to auto enable or improve the 256 colors usage:


* coreutils (for the ls color schem)
* coreutils (for the ls color schem)
* vim-common (to improve the vim color schem)
* vim-common (to improve the vim color scheme)
* gnome-terminal
* [[Features/256_Color_Terminals#May_auto_support_256_colors_in_future]] (to add COLORTERM to the env)
* xterm
* konsole
* terminal
* tmux?
* screen?
* [other terms to handle]


== Contingency Plan ==
== Contingency Plan ==

Revision as of 17:04, 3 August 2012

256 Color Terminals

Summary

Enable terminal programs to use the enhanced color capabilities of modern terminals by default.

I.E. increase their color options from the 8 colors at the top of this picture, to the other 256 displayed.

16 to 256.png

Owner

Current status

  • Targeted release: Fedora 18
  • Last updated: 2012-08-01
  • Percentage of completion: 90%

Detailed Description

Many terminal programs (like vim and ls for example) can take advantage of 256 color terminals, and all xterms I know of support at least 256 colors and sometimes more.
So let's break through the artificial 8 color limit!

Also when preparing this page, while searching the net I noticed that Mac OS X Terminal's default $TERM value is xterm-256color since Lion 10.7 That will ease some of the compatibility issues noted below.

You can see vim's default appearance using the above expanded palette at:

http://www.pixelbeat.org/docs/terminal_colours/#256

Benefit to Fedora

By having 32 times more colors available gives much better scope for using more appropriate default colors. For example, users could set their terminal backgrounds to dark or light and have ls use colors that are appropriate to either.

Also more subtle and considered coloring can be used as discussed and depicted at: https://github.com/seebi/dircolors-solarized

Scope

This will be mainly configuration changes.

After some discussion around whether it was best to update each terminal to adjust the TERM environment variable, or whether to have a central config file, it was initially decided to update each terminal. But after looking more deeply into this I thought of a way to use the simple centralized config, without causing an issue for remote terminals logging into the system. By keying on $COLORTERM rather than $TERM we both get accurate identification of the terminal, and non propagation by ssh. I.E. we get to easily and centrally configure this feature for particular terminals and also avoid having to add config options to each terminal some of which discourage new config options on principle.

Here are setting notes on setting $TERM on various terminals: Noted there was the fact that it's not configurable in gnome-terminal (vte) yet.

There is a related bug to set $TERM to 'gnome' 'gnome-256color', though we probably should stick to 'xterm' to reduce remote interop issues (ubuntu precise for example doesn't support TERM=gnome)

Here are notes on the xfce bug where it doesn't set the specified TERM correctly: http://forums.opensuse.org/english/get-technical-help-here/how-faq-forums/unreviewed-how-faq/459826-setting-term-xfce-terminal-bug-description-workaround.html https://bugs.archlinux.org/task/21007#comment94595

Here is the current version of the /etc/profile.d/256color.sh file.

# Uncomment this if you want remote xterms connecting
# to this system, to be sent 256 colors.  Note that
# local xterms, ssh'ing to localhost are considered
# remote in this context, but in that case, $TERM should
# have already been set to 256 color capable.
#
# SEND_256_COLORS_TO_REMOTE=1

# Terminals with any of the following set, support 256 colors (and are local)
local256="$COLORTERM$XTERM_VERSION$ROXTERM_ID$KONSOLE_DBUS_SESSION"

if test "$local256" || test "$SEND_256_COLORS_TO_REMOTE"; then

  case "$TERM" in
    'xterm') TERM=xterm-256color;;
    'screen') TERM=screen-256color;;
    'Eterm') TERM=Eterm-256color;;
  esac
  export TERM

  if [ ! -z "$TERMCAP" ] && [ "$TERM" = "screen-256color" ]; then
    TERMCAP=$(echo "$TERMCAP" | sed -e 's/Co#8/Co#256/g')
    export TERMCAP
  fi
fi

unset local256

As an optional additional improvement, we could adjust the 256 color values used in ls by editing the /etc/DIR_COLORS.256color file in the coreutils package, as it doesn't take as much advantage of the color range as it could.

As the default vim color scheme has some issues in 256 colors, we should also provide updates on this. Search, SpellLocal, ColorColumn and MatchParen are hardly readable (see :hi under vim). We should also avoid uses of bold attribute in vim highlighting as it can look bad especially at smaller font sizes. There are only a couple of uses of bold in the 256 color scheme so they can be easily avoided. Bold should be left in the vim 8 color scheme due to the effective doubling of colors that provides.

How To Test

Test as many colored terminal apps as possible under as many terminals as possible. Ensure screen works as expected too. There are screen testing notes at: http://www.robmeerman.co.uk/unix/256colours

To get the color numbers of your actual TERM, use the following:

$ tput colors
256

For testing any ls color changes you can use this command:

eval $(dircolors /etc/DIR_COLORS.256color)
echo $LS_COLORS | tr : '\n' | sed 's/\(.*\)=\(.*\)/\x1b[\2m\1\t\2\x1b[0m/'

User Experience

Better default colors with less tweaking required.

Dependencies / Affected packages

The following packages could be updated in order to auto enable or improve the 256 colors usage:

Contingency Plan

None necessary, revert to previous release behaviour

Documentation

Caveats

  • The linux terminal (i.e. those on virtual consoles) doesn't support 256 colors and will break if applications send 256 color codes to it. This is handled in the config file above.
  • Local xterms support this feature fine, though once you connect to other systems with SSH (which propagates the TERM environment variable), they will have to support the $TERM, or otherwise you will have a degraded experience. Debian for example traditionally didn't support xterm-256color unless the ncurses-term package was installed. Note ubuntu 12.04 at least does support xterm-256color so this is improving. Also as noted above Mac OS X 10.7 defaults to xterm-256color and so they're paving the way somewhat in this regard, so there should be less issues in connecting to older systems going forward.

Terminal 256 color support list

Will be enabled with 256 colors automatically

  • gnome-terminal
  • konsole could be improved slightly
  • mate-terminal
  • Terminal
  • eterm
  • xterm
  • roxterm
  • terminator
  • rxvt256c (already defaults to 256 color)
  • urxvt256c (already defaults to 256 color)
  • st (already defaults to 256 color)
  • screen
  • tmux (uses screen env settings)

Don't support 256 colors

  • tn5250
  • x3270
  • rxvt (8)
  • urxvt (88)
  • aterm

May auto support 256 colors in future

These terminals can support 256 colors but are not identifiable using env variables. It would make sense to modify these to set COLORTERM

  • lxterminal
  • termit
  • tilda
  • sakura
  • yakuake
  • guake
  • mrxvt

Release Notes

256 color terminals are enabled by default, which may causes minor issues when sshing to certain older systems.

This is because ssh will propagate the TERM environment variable which the remote system may not support, in which case you could receive "unknown" or "not fully functional" terminal status messages.

Unsetting 256 color on the remote system

The simplest way to address this issue is by setting the TERM variable back to the widely supported xterm value.

This could be done for example by adding the following to your ~/.profile on the remote system:

test "SSH_CONNECTION" && export TERM=xterm

Adjusting the remote system to support 256 colors

There are often only small adjustments needed to get a remote system to support 256 colors. On older debian systems for example you just need to install the ncurses-term package.

Another option is to copy the terminfo to the remote system as documented at 'running rxvt-unicode with remotes hosts'

Comments and Discussion