so-fancy /diff-so-fancy

Make your diffs human readable for improved code quality and faster defect detection. :tada:

★ 18,121⑂ 352👁 106⑃ 240● 315▤ 41
PerlMITCreated 2016-02-04
下载:v1.4.14v1.4.14 ↓1.4.142026-10-03
+2
日增长
18,121
stars
352
forks
106
watchers
240
prs
315
issues
41
releases

README

🎩 diff-so-fancy   

diff-so-fancy makes your diffs human-readable instead of machine-readable. This helps improve code quality and helps you spot defects faster.

 🖼️ Screenshot

Vanilla git diff vs git and diff-so-fancy

!diff-highlight vs diff-so-fancy

 📦 Install

Simply copy the diff-so-fancy script from the latest Github release into your $PATH and you're done. Alternately to test development features you can clone this repo and then put the diff-so-fancy script (symlink will work) into your $PATH. The lib/ directory will need to be kept relative to the core script.

diff-so-fancy is also available from the NPM registry, brew, Fedora, in the Arch extra repo, and as ppa:aos for Debian/Ubuntu Linux.

Issues relating to packaging ("installation does not work", "version is out of date", etc.) should be directed to those packages' repositories/issue trackers where applicable.

 ✨ Usage

 Git

Configure git to use diff-so-fancy for all diff output:

shell
git config --global core.pager "diff-so-fancy | less --tabs=4 -RF"
git config --global interactive.diffFilter "diff-so-fancy --patch"


 Diff

Use -u with diff for unified output, and pipe the output to diff-so-fancy:

shell
diff -u file_a file_b | diff-so-fancy


We also support recursive mode with -r or --recursive

shell
diff --recursive -u /path/folder_a /path/folder_b | diff-so-fancy


 ⚒️ Options

 markEmptyLines

Colorize the first block of an empty line. (Default: true)

shell
git config --bool --global diff-so-fancy.markEmptyLines false


 changeHunkIndicators

Simplify Git header chunks to a human readable format. (Default: true)

shell
git config --bool --global diff-so-fancy.changeHunkIndicators false


 stripLeadingSymbols

Remove the + or - symbols at start of each diff line. (Default: true)

shell
git config --bool --global diff-so-fancy.stripLeadingSymbols false


 useUnicodeRuler

Use Unicode to draw the ruler lines. Setting this to false will use ASCII
instead. (Default: true)

shell
git config --bool --global diff-so-fancy.useUnicodeRuler false


 rulerWidth

rulerWidth sets the width of the ruler lines. (Default: screen width)

shell
git config --global diff-so-fancy.rulerWidth 80


 fileNameRulerShape

Shape of the ruler drawn around file names in git show output. Set this to
ruler to use full width ruler lines instead of boxes. (Default: box)

shell
git config --global diff-so-fancy.fileNameRulerShape ruler


 shortHeaders

Simplify the header information to a single line for filename and line
number. (Default false)

shell
git config --global diff-so-fancy.shortHeaders true


 semIntegration

Include the summary from sem in the header
for each changed file. (Default false)

shell
git config --global diff-so-fancy.semIntegration true


 👨 The diff-so-fancy team

| Person                | Role             |
| --------------------- | ---------------- |
| @scottchiefbaker      | Project lead     |
| @OJFord               | Bug triage       |
| @GenieTim             | Travis OSX

Top issues

Latest release

v1.4.14 v1.4.14 2026-10-03
New features
- OSC 1717 diff-line metadata support for Lazygit —  538:
- fileNameRulerShape option — 545, closes 522:
- box (default) vs ruler shape for file names in git show mode.
- Terminal now reads from env $COLUMNS before falling back to tput — 556:
- --date iso support — 27e0ce5 + test for 540:
- Adds a simple Makefile

 Fixes
- Fix crash on git dates without timezone offset (log.date=local) — 544.
- Fix binary file parser when filename contains  and  — 547.
- Fix filename parsing when path contains b/ segment — 549.
- Fix crash on diff ending on truncated old mode line — 55

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON