https://github.com/burntcarrot/difftective

Tool for detecting visual differences in images/PDFs.
https://github.com/burntcarrot/difftective

go image pdf visual-diff

Last synced: about 1 month ago
JSON representation

Tool for detecting visual differences in images/PDFs.

• Host: GitHub
• URL: https://github.com/burntcarrot/difftective
• Owner: burntcarrot
• License: mit
• Created: 2022-08-15T14:32:25.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-08-20T17:03:06.000Z (over 3 years ago)
• Last Synced: 2025-09-24T22:39:33.008Z (6 months ago)
• Topics: go, image, pdf, visual-diff
• Language: Go
• Homepage:
• Size: 1.63 MB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


    



# difftective

_difference + detective = difftective_

`difftective` is a tool for detecting visual differences in images/PDFs.

## Examples

Document looking like the same? No update history? Find visual differences with `difftective`:

_Note: There are other services which provide text diff for PDFs; `difftective`, however provides an easy way to detect changes through visual differences._

| expected | actual | diff |

| --- | --- | --- |

| ![Old Document](examples/policy/test-policy-old.png) | ![New Document](examples/policy/test-policy-new.png) | ![Diff Document](examples/policy/diff.png) |

On a [classic Mapbox example](https://github.com/mapbox/pixelmatch):

| expected | actual | diff |

| --- | --- | --- |

| ![Old Map](examples/mapbox/mapbox1.png) | ![New Map](examples/mapbox/mapbox2.png) | ![Map Difference](examples/mapbox/diff.png) |

## Installation

Using `go install`:

```sh

go install github.com/burntcarrot/difftective@latest

```

## Usage

```sh

$ difftective

difftective v0.1.0 - Detect differences in images and PDFs

Available commands:

   pdf     Use PDFs

   image   Use images

Flags:

      --help   Get       help for the 'difftective' command.

```

Detect differences in PDFs:

```sh

$ difftective pdf -p policy-old.pdf -n policy-new.pdf -o diff.png

Difference: 0.093%

Saved difference to diff.png

```

Detect differences in images:

```sh

$ difftective image -p examples/mapbox/mapbox1.png -n examples/mapbox/mapbox2.png -o diff.png

Difference: 38.301%

Saved difference to diff.png

```

## License

`difftective` is released under the MIT license. See [LICENSE](./LICENSE).