622

When I have a diff, how can I colorize it so that it looks good?

I want it for the command line, so please no GUI solutions.

3
  • 7
    Any particular operating system/shell? Commented Jan 10, 2012 at 8:55
  • 4
    Try github.com/walles/riff. As an added bonus, it highlights what parts of the lines that changed. Commented Jul 3, 2015 at 19:02
  • emacs does great color diffs in a terminal; is that what you mean by non-GUI? See unix.stackexchange.com/a/613399/80268 . Commented Nov 12, 2020 at 23:30

17 Answers 17

715

Man pages for diff suggest no solution for colorization from within itself. Please consider using colordiff. It's a wrapper around diff that produces the same output as diff, except that it augments the output using colored syntax highlighting to increase readability:

diff old new | colordiff

or just:

colordiff old new

Installation:

  • Ubuntu/Debian: sudo apt-get install colordiff
  • OS X: brew install colordiff or port install colordiff
Sign up to request clarification or add additional context in comments.

9 Comments

Just found that myself :-). It can be piped into less by using less -R, which displays the escape sequences for colors correctly.
Can just use the syntax: colordiff file1 file2
Alas, it doesn't work for the side-by-side output (-y option to enable) ☹ The vimdiff suggestion below probably a better way
colordiff works well for svn diff | colordiff (i.e. in situations where you only have the diff, not the two files being diffed).
As an update to @Hi-Angel 's comment: colordiff has been updated and now includes side by side (-y) support.
|
389

Use Vim:

diff /path/to/a /path/to/b | vim -R -

Or better still, VimDiff (or vim -d, which is shorter to type) will show differences between two, three or four files side-by-side.

Examples:

vim -d /path/to/[ab]

vimdiff file1 file2 file3 file4

15 Comments

@Jichao: I prefer to learn the commands rather than alias them away. That way I can use them anywhere, even when my dotfiles aren't available.
@AquariusPower: ctrl-c and ctrl-x have other uses in Vim. ctrl-q is captured by many terminals. See Writing and quitting to find the way that best suits your needs.
vimdiff won't handle directory diffs. Alternatively, you can save diff to a file, and open it with vim. That way you will have vim colorize it using built-in syntax highlighting facilities.
First, what kind of shell is this? zsh? I don't recognize =(...) construct. Second, I had diff -ur a b in mind.
|
211

Actually there seems to be yet another option (which I only noticed recently, when running into the problem described above):

git diff --no-index <file1> <file2>
# output to console instead of opening a pager
git --no-pager diff --no-index <file1> <file2>

If you have Git around (which you already might be using anyway), then you will be able to use it for comparison, even if the files themselves are not under version control. If not enabled for you by default, then enabling color support here seems to be considerably easier than some of the previously mentioned workarounds.

12 Comments

This is neat, but sadly this doesn't work when the inputs are pipes. For example comparing binary files via git diff <(xxd file1) <(xxd filed) doesn't work.
Oddly, at least one of the files has to be 'outside the current repository', according to git help diff. So if your git diff is coming up empty, try cd out of where you are.
To enable colors for git diff: git config color.diff auto
If both files are inside the current repository, use git diff --no-index to compare two files.
I'm a fan of git diff --word-diff --patience
|
163

diff --color option (added to GNU diffutils 3.4 in 2016-08-08)

This is the default diff implementation on most distributions, which will soon be getting it.

Ubuntu 18.04 (Bionic Beaver) has diffutils 3.6 and therefore has it.

On 3.5 it looks like this:

Enter image description here

Tested with:

diff --color -u \
  <(seq 6 | sed 's/$/ a/') \
  <(seq 8 | grep -Ev '^(2|3)$' | sed 's/$/ a/')

Apparently added in commit c0fa19fe92da71404f809aafb5f51cfd99b1bee2 (Mar 2015).

Word-level diff

Like diff-highlight. It is not possible it seems, but there is a feature request: https://lists.gnu.org/archive/html/diffutils-devel/2017-01/msg00001.html

Related questions:

ydiff does it though. See below.

ydiff side-by-side word level diff

https://github.com/ymattw/ydiff

Is this nirvana?

python3 -m pip install --user ydiff
diff -u a b | ydiff -s

Outcome:

Enter image description here

If the lines are too narrow (default 80 columns), fit to the screen with:

diff -u a b | ydiff -w 0 -s

Contents of the test files:

a

1
2
3
4
5 the original line the original line the original line the original line
6
7
8
9
10
11
12
13
14
15 the original line the original line the original line the original line
16
17
18
19
20

b

1
2
3
4
5 the original line the original line the original line the original line
6
7
8
9
10
11
12
13
14
15 the original line the original line the original line the original line
16
17
18
19
20

ydiff Git integration

ydiff integrates with Git without any configuration required.

From inside a Git repository, instead of git diff, you can do just:

ydiff -s

and instead of git log:

ydiff -ls

See also: How can I get a side-by-side diff when I do "git diff"?

Tested on Ubuntu 16.04 (Xenial Xerus), Git 2.18.0, and ydiff 1.1.

5 Comments

Here is the documentation.
In that mailing list thread: There is no word-highlighting, yet - any updates? This is what I came to this question for (I want grep --color-like diff output).
@i336_ no updates unfortunately, if I get any, I will update the question. Ping me if you find anything.
By the way git diff --color works too. Useful when working over ssh.
Diff too large? use diff --color=always | less -R
81

And for those occasions when a yum install colordiff or an apt-get install colordiff is not an option due to some insane constraint beyond your immediate control, or you're just feeling crazy, you can reinvent the wheel with a line of sed:

sed 's/^-/\x1b[41m-/;s/^+/\x1b[42m+/;s/^@/\x1b[34m@/;s/$/\x1b[0m/'

Throw that in a shell script and pipe unified diff output through it.

It makes hunk markers blue and highlights new/old filenames and added/removed lines in green and red background, respectively.1 And it will make trailing space2 changes more readily apparent than colordiff can.


1 Incidentally, the reason for highlighting the filenames the same as the modified lines is that to correctly differentiate between the filenames and the modified lines requires properly parsing the diff format, which is not something to tackle with a regex. Highlighting them the same works "well enough" visually and makes the problem trivial. That said, there are some interesting subtleties.

2 But not trailing tabs. Apparently tabs don't get their background set, at least in my xterm. It does make tab vs. space changes stand out a bit though.

12 Comments

@Matt: Here's a brute-force approach for a Mac: sed "s/^-/`echo -e \"\x1b\"`[41m-/;s/^+/`echo -e \"\x1b\"`[42m+/;s/^@/`echo -e \"\x1b\"`[34m@/;s/$/`echo -e \"\x1b\"`[0m/" (though I expect there is a better way).
Hmm, it sort of worked... gave the 3 dashes between each chunk a pink background.
Dude this is awesome! Way to go! That is some nice sed wizardry.
aliased this awesomeness as colorize-diff-u. Thanks.
sed 's/^-/\x1b[31m-/;s/^+/\x1b[32m+/;s/^@/\x1b[34m@/;s/$/\x1b[0m/' looks also great
|
20

Coloured, word-level diff ouput

Here's what you can do with the the below script and diff-highlight:

Coloured diff screenshot

#!/bin/sh -eu

# Use diff-highlight to show word-level differences

diff -U3 --minimal "$@" |
  sed 's/^-/\x1b[1;31m-/;s/^+/\x1b[1;32m+/;s/^@/\x1b[1;34m@/;s/$/\x1b[0m/' |
  diff-highlight

(Credit to @retracile's answer for the sed highlighting)

4 Comments

How do I use this output in GVim?
For vim, use a plugin, eg diffchar.
This answer deserves more credit! It uses a toolchain you probably already have, and works awesome (and applies to git log, git show, and git diff!
Actually, diff-highlight does not do a word-level output. It just detects a common prefix and a common suffix on a changed line. For instance, if several words are changed, it will highlight everything from the first changed word to the last changed word. Moreover, this is effective only when only one line is changed between unchanged lines. In GNU Emacs, diff-mode does much better.
16

You can change the Subversion configuration to use colordiff:

~/.subversion/config.diff

 ### Set diff-cmd to the absolute path of your 'diff' program.
 ###   This will override the compile-time default, which is to use
 ###   Subversion's internal diff implementation.
-# diff-cmd = diff_program (diff, gdiff, etc.)
+diff-cmd = colordiff

via: https://gist.github.com/westonruter/846524

4 Comments

svn: Can't start process 'colordiff': Resource temporarily unavailable
Did you install colordiff?
Yup, I tried hardcoding the path as well (running in cygwin)
12

Since wdiff accepts arguments specifying the string at the beginning and end of both insertions and deletions, you can use ANSI color sequences as those strings:

wdiff -n -w $'\033[30;41m' -x $'\033[0m' -y $'\033[30;42m' -z $'\033[0m' file1 file2

For example, this is the output of comparing two CSV files:

diff output of CSV files

Example from 2.2 Actual examples of wdiff usage.

1 Comment

colordiff now (1.0.16) understands wdiff, so you can also just pipe: wdiff -n f1 f2 | colordiff. wdiff should be merged into diffutils...
11

I use grc (Generic Colouriser), which allows you to colour the output of a number of commands including diff.

It is a Python script which can be wrapped around any command. So instead of invoking diff file1 file2, you would invoke grc diff file1 file2 to see colourised output. I have aliased diff to grc diff to make it easier.

1 Comment

Does not work on Windows with mingw/cygwin due to fork() calls, although likely to work with WSL.
11

No one has mentioned delta so far. It supports syntax colored diff view with syntax highlighting.

Image source: Delta

4 Comments

Wohoooo is this a terminal application?!
doesn't seem to support .diff files
It's in Pacman... delta -s file1 file2 # -s is "side by side"
brew install git-delta
11

Here is another solution that invokes sed to insert the appropriate ANSI escape sequences for colors to show the +, -, and @ lines in red, green, and cyan, respectively.

diff -u old new | sed "s/^-/$(tput setaf 1)&/; s/^+/$(tput setaf 2)&/; s/^@/$(tput setaf 6)&/; s/$/$(tput sgr0)/"

Unlike the other solutions to this question, this solution does not spell out the ANSI escape sequences explicitly. Instead, it invokes the tput setaf and tput sgr0 commands to generate the ANSI escape sequences to set an appropriate color and reset terminal attributes, respectively.

To see the available colors for each argument to tput setaf, use this command:

for i in {0..255}; do tput setaf $i; printf %4d $i; done; tput sgr0; echo

Here is how the output looks:

enter image description here

Here is the evidence that the tput setaf and tput sgr0 commands generate the appropriate ANSI escape sequences:

$ tput setaf 1 | xxd -g1
00000000: 1b 5b 33 31 6d                                   .[31m
$ tput setaf 2 | xxd -g1
00000000: 1b 5b 33 32 6d                                   .[32m
$ tput setaf 6 | xxd -g1
00000000: 1b 5b 33 36 6d                                   .[36m
$ tput sgr0 | xxd -g1
00000000: 1b 28 42 1b 5b 6d                                .(B.[m

1 Comment

if you get tput: unkown terminfo capability in 'srg0' means your os is old and tput does not recognize srg0 , i was able to use tput setaf 7 in last sed command to get color back to white
6

Character-level color diff: Install ccdiff

ccdiff -r /usr/share/dict/words /tmp/new-dict

Output of ccdiff

1 Comment

ccdiff seems to work well as a diff program, but unfortunately, it cannot color an existing diff (such as a patch).
4

I would suggest you to give diff-so-fancy a try. I use it during my work and it sure seems great as of now. It comes packed with many options and it's really easy to configure your diffs the way you want.

You can install it by:

sudo npm install -g diff-so-fancy

or on Mac:

brew install diff-so-fancy

Afterwards, you can highlight your diffs like this:

diff -u file1 file2 | diff-so-fancy

Comments

4
diff --color=always file_a file_b | less

works for me

Comments

2

With the bat command:

diff file1 file2 | bat -l diff

1 Comment

What is bat supposed to do? Can you elaborate? Please respond by editing (changing) your answer, not here in comments (without "Edit:", "Update:", or similar - the answer should appear as if it was written today).
0

On recent versions of Git on Ubuntu, you can enable diff-highlighting with:

sudo ln -s /usr/share/doc/git/contrib/diff-highlight/diff-highlight /usr/local/bin
sudo chmod a+x /usr/share/doc/git/contrib/diff-highlight/diff-highlight

And then adding this to your .gitconfig file:

[pager]
    log = diff-highlight | less
    show = diff-highlight | less
    diff = diff-highlight | less

It's possible the script is located somewhere else in other distributions. You can use locate diff-highlight to find out where.

Comments

0

My favorite choice is vdiff <file1> <file2> function (I forgot from where I got it).

It will open two windows in Vim side-by-side, to see clearly see the difference between the two files.

vdiff () {
    if [ "${#}" -ne 2 ] ; then
        echo "vdiff requires two arguments"
        echo "  comparing dirs:  vdiff dir_a dir_b"
        echo "  comparing files: vdiff file_a file_b"
        return 1
    fi

    local left="${1}"
    local right="${2}"

    if [ -d "${left}" ] && [ -d "${right}" ]; then
        vim +"DirDiff ${left} ${right}"
    else
        vim -d "${left}" "${right}"
    fi
}

Put this script in your (.alias) or (.zshrc), and then call it using vdiff <file1> <file2>.

Example

Enter image description here

The results are:

Enter image description here

Comments

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.