Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

improved colored diff

Project Description

# Icdiff

Improved colored diff


## Installation

Download the [latest]( `icdiff` binary and put it on your PATH.

Install with pip from PyPI
pip install icdiff

Alternatively, install with pip from github:
pip install git+

## Usage

icdiff [options] left_file right_file

Show differences between files in a two column view.

### Options
--version show program's version number and exit
-h, --help show this help message and exit
--cols=COLS specify the width of the screen. Autodetection is Unix
--encoding=ENCODING specify the file encoding; defaults to utf8
--head=HEAD consider only the first N lines of each file
-H, --highlight color by changing the background color instead of the
foreground color. Very fast, ugly, displays all
override file labels with arbitrary tags. Use twice,
one for each file
-N, --line-numbers generate output with line numbers
--no-bold use non-bold colors; recommended for with solarized
--no-headers don't label the left and right sides with their file
specify the output encoding; defaults to utf8
--recursive recursively compare subdirectories
--show-all-spaces color all non-matching whitespace including that which
is not needed for drawing the eye to changes. Slow,
ugly, displays all changes
--tabsize=TABSIZE tab stop spacing
-u, --patch generate patch. This is always true, and only exists
for compatibility
-U NUM, --unified=NUM, --numlines=NUM
how many lines of context to print; can't be combined
with --whole-file
-W, --whole-file show the whole file instead of just changed lines and

## Using with git

To see what it looks like, try:

git difftool --extcmd icdiff

To install this as a tool you can use with git, copy
`git-icdiff` onto your path and run:

git icdiff

## Using with subversion

To try it out, run:

svn diff --diff-cmd icdiff

## Using with Mercurial

Add the following to your `~/.hgrc`:


opts.icdiff=--recursive --line-numbers

Or check more [in-depth setup instructions](

## Running tests

./ python2
./ python3

## License

This file is derived from `difflib.HtmlDiff` which is under the [license](
I release my changes here under the same license. This is GPL compatible.

Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(9.1 kB) Copy SHA256 Hash SHA256
Source Jun 7, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting