https://github.com/dandavison/delta

A syntax-highlighting pager for git, diff, and grep output
https://github.com/dandavison/delta

color-themes delta diff git git-delta pager rust syntax-highlighter

Last synced: about 1 month ago
JSON representation

A syntax-highlighting pager for git, diff, and grep output

• Host: GitHub
• URL: https://github.com/dandavison/delta
• Owner: dandavison
• License: mit
• Created: 2019-06-24T15:00:13.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2024-05-10T17:05:30.000Z (about 1 month ago)
• Last Synced: 2024-05-10T18:24:44.975Z (about 1 month ago)
• Topics: color-themes, delta, diff, git, git-delta, pager, rust, syntax-highlighter
• Language: Rust
• Homepage: https://dandavison.github.io/delta/
• Size: 9.78 MB
• Stars: 20,845
• Watchers: 79
• Forks: 344
• Open Issues: 282
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Lists

• links - delta
• awesome-list - delta
• awesome-list - delta
• command-line-tools - delta - Syntax-highlighter for git and diff output. (Other)
• awesome-alternatives-in-rust - delta - A viewer for git and diff output (Applications / System tools)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21161 | (Rust)
• cli-apps - delta - A syntax-highlighter for git and diff output. (<a name="diff"></a>Diff)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• my-awesome-stars - delta - highlighting pager for git, diff, and grep output | dandavison | 18628 | (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• orm-awesome - delta
• awesome-stars - delta - highlighting pager for git, diff, and grep output | dandavison | 15093 | (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, and grep output | dandavison | 15093 | (Rust)
• awesome-tuis - delta - highlighting pager for git, diff, and grep output. (Table of Contents)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-github-repos - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - highlighting pager for git, diff, and grep output (Rust)
• awesome-rust-tools - delta - highlighting pager for git, diff, and grep output. (Dev-Utilities)
• my-awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-tools - delta
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, and grep output (Rust)
• awesome - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-terminals - delta - A viewer for git and diff output (Tools / Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, and grep output | dandavison | 15093 | (Rust)
• awesome-stars - delta - highlighting pager for git, diff, and grep output | dandavison | 14576 | (Rust)
• awesome-terminal - delta
• my-awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, and grep output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, and grep output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21149 | (Rust)
• fuck-awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• my-awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• my-awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, and grep output (Rust)
• my-awesome-github-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21155 | (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-github-star - delta - highlighting pager for git, diff, and grep output | dandavison | 18612 | (Rust)
• awesome-developer-resources - git-delta
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighting pager for git | dandavison | 10836 | (Rust)
• awesome-stars - delta - highlighting pager for git, diff, and grep output | dandavison | 15537 | (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, and grep output | dandavison | 14182 | (Rust)
• awesome-stars - delta - highlighting pager for git, diff, and grep output | dandavison | 12899 | (Rust)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21133 | (Rust)
• my-awesome - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• my-personal-awesome - git-delta - highlighting pager for git and diff output. ![OSS][oss] ![Linux][linux] ![Mac][mac] ![Windows][windows] ![CLI][cli] (Programming.)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21183 | (Rust)
• awesome-starred-test - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• my-awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• stars - dandavison/delta - highlighting pager for git, diff, grep, and blame output (HarmonyOS / Windows Manager)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 20996 | (Rust)
• my-awesome - dandavison/delta - themes,delta,diff,git,git-delta,pager,rust,syntax-highlighter pushed_at:2024-05 star:21.0k fork:0.4k A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• my-awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (rust)
• awesome-stars - delta
• awesome-cli-tui-software - dandavison/delta - A viewer for git and diff output (<a name="git"></a>git)
• awesome-diff-tools - delta - Pager for (git) diff, adds syntax highlighting, inline and side-by-side view, support for git blame and merge conflicts. (Source Code / Diff Enhancers)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-starred - dandavison/delta - A syntax-highlighting pager for git, diff, and grep output (rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighter for git and diff output | dandavison | 1026 | (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome - delta - A viewer for git and diff output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21147 | (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-devtools - Delta - A tool to see differences between text files. ![ossoft][oss] (Command line - Linux / Learning resources)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, and grep output (Rust)
• awesome-tools - git-delta - git diff 加强。 (Git / Snippets Manager)
• jimsghstars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-starred - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21126 | (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-repositories - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21177 | (Rust)
• awesome-cli-apps - delta - A syntax-highlighter for git and diff output. (<a name="diff"></a>Diff)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - `★21162` A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21155 | (Rust)
• awesome-stars - delta - highlighting pager for git, diff, grep, and blame output | dandavison | 21134 | (Rust)
• awesome-repositories - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)
• awesome-stars - dandavison/delta - A syntax-highlighting pager for git, diff, grep, and blame output (Rust)

README

        


  





  

    

  

  

    

  

  

    

  



## Get Started

[Install it](https://dandavison.github.io/delta/installation.html) (the package is called "git-delta" in most package managers, but the executable is just `delta`) and add this to your `~/.gitconfig`:

```gitconfig

[core]

    pager = delta

[interactive]

    diffFilter = delta --color-only

[delta]

    navigate = true    # use n and N to move between diff sections

    # delta detects terminal colors automatically; set one of these to disable auto-detection

    # dark = true

    # light = true

[merge]

    conflictstyle = diff3

[diff]

    colorMoved = default

```

Delta has many features and is very customizable; please see the [user manual](https://dandavison.github.io/delta/).

## Features

- Language syntax highlighting with the same syntax-highlighting themes as [bat](https://github.com/sharkdp/bat#readme)

- Word-level diff highlighting using a Levenshtein edit inference algorithm

- Side-by-side view with line-wrapping

- Line numbering

- `n` and `N` keybindings to move between files in large diffs, and between diffs in `log -p` views (`--navigate`)

- Improved merge conflict display

- Improved `git blame` display (syntax highlighting; `--hyperlinks` formats commits as links to hosting provider etc. Supported hosting providers are: GitHub, GitLab, SourceHut, Codeberg)

- Syntax-highlights grep output from `rg`, `git grep`, `grep`, etc

- Support for Git's `--color-moved` feature.

- Code can be copied directly from the diff (`-/+` markers are removed by default).

- `diff-highlight` and `diff-so-fancy` emulation modes

- Commit hashes can be formatted as terminal [hyperlinks](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda) to the hosting provider page (`--hyperlinks`).

  File paths can also be formatted as hyperlinks for opening in your OS.

- Stylable box/line decorations to draw attention to commit, file and hunk header sections.

- Style strings (foreground color, background color, font attributes) are supported for >20 stylable elements, using the same color/style language as git

- Handles traditional unified diff output in addition to git output

- Automatic detection of light/dark terminal background

## A syntax-highlighting pager for git, diff, and grep output

Code evolves, and we all spend time studying diffs. Delta aims to make this both efficient and enjoyable: it allows you to make extensive changes to the layout and styling of diffs, as well as allowing you to stay arbitrarily close to the default git/diff output.

  

    

      

      


      delta with line-numbers activated

    

  

  

    

      

      


      delta with side-by-side and line-numbers activated

    

  

Here's what `git show` can look like with git configured to use delta:




  

    

      

    

    

      

    

  

  

    

      "Dracula" theme

    

    

      "GitHub" theme

    

  







### Syntax-highlighting themes

**All the syntax-highlighting color themes that are available with [bat](https://github.com/sharkdp/bat/) are available with delta:**




  

    

      

    

    

      

    

  

  

    

      delta --show-syntax-themes --dark

    

    

      delta --show-syntax-themes --light

    

  




### Side-by-side view

[[User manual](https://dandavison.github.io/delta/side-by-side-view.html)]

```gitconfig

[delta]

    side-by-side = true

```

By default, side-by-side view has line-numbers activated, and has syntax highlighting in both the left and right panels: [[config](#side-by-side-view-1)]



Side-by-side view wraps long lines automatically:



### Line numbers

[[User manual](https://dandavison.github.io/delta/line-numbers.html)]

```gitconfig

[delta]

    line-numbers = true

```



### Merge conflicts

[[User manual](https://dandavison.github.io/delta/merge-conflicts.html)]



### Git blame

[[User manual](https://dandavison.github.io/delta/git-blame.html)]



### Ripgrep, git grep

[[User manual](https://dandavison.github.io/delta/grep.html)]



### Installation and usage

Please see the [user manual](https://dandavison.github.io/delta/) and `delta --help`.