---
name: "lepton-schdiff"
section: "1"
platform: "linux"
package: "lepton-eda"
version: "1.9.18-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/lepton-schdiff"
---

# lepton-schdiff(1)

Graphical diff tool for schematics

## NAME

**lepton-schdiff** - Graphical diff tool for schematics

## SYNOPSIS

**lepton-schdiff** *\[-d VIEWER\] infile1.sch infile2.sch*

## DESCRIPTION

The **lepton-schdiff** program will use **[ImageMagick(1)](/ImageMagick/1.md)** to display a graphical diff of two schematic files.  It's most useful when combined with a revision control system so it can compare two revisions of the same file, review changes, etc.  However, it is limited in that it can only compare two files at a time; it cannot diff entire directories nor can it diff an entire revision (unless that revision affected only one file).

*VIEWER* command, if specified, will be used to display the result. By default, it's **display** program from the ImageMagick package.

**lepton-schdiff** can easily be configured to work with most revision control systems.  Here are instructions for three:

**git:** Use the **difftool** command exactly as you would use **diff** , but supply the **-x lepton-schdiff** option.

**mercurial:** Use the **lepton-schdiff** command exactly as you would use **diff** , but add the following lines to your .hgrc:

  \[extensions\]\
   hgext.extdiff =\
   \[extdiff\]\
   cmd.schdiff = lepton-schdiff

**subversion:** Use the **diff** command like normal, but supply the **--diff-cmd lepton-schdiff** option.

**Note:** To make lepton-schdiff work properly, all page contents should be enclosed in some form of bounding box (e.g. a title block), otherwise the symbols in exported images could have different relative positions and/or sizes, resulting in a difference image that is rather hard to comprehend.

## EXAMPLES

- Use git to view the changes to a file between two revisions

  git difftool -x lepton-schdiff 182110f 039e012 cpu.sch

- Use mercurial to see all the changes since a specific revision

  hg schdiff -r 8442880f9835 cpld.sch

- Use subversion to review a specific revision

  svn diff --diff-cmd lepton-schdiff -c 49 power.sch

## BUGS

If you find one, please report it at https://github.com/lepton-eda/lepton-eda/issues

## AUTHOR

Alan Somers

## SEE ALSO

**[composite(1)](/composite/1.md), [display(1)](/display/1.md), [git(1)](/git/1.md), [lepton-schematic(1)](/lepton-schematic/1.md), [hg(1)](/hg/1.md), [svn(1)](/svn/1.md)**

## COPYRIGHT

```
Copyright © 2011-2014 gEDA Contributors.
Copyright © 2018-2022 Lepton EDA Contributors.
License GPLv2+: GNU GPL version 2 or later. Please see the `COPYING'
file included with this program for full details.
```

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.