Git hooks to automatically generate layer images of Eagle BRD files, intended for visual diffs
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Eagle Preview Autogen

Git hooks to aid Eagle users in encouraging visual diffs. These scripts will run automatically when you commit any board changes, generating preview images and gerber files suitable for distribution, and can include them in every commit. By default, only the images are added, to simplify changelogs.

If ImageMagick is installed, it also generates a visual diff of board changes, and includes those into your commit as well. This technique is based off Evil Mad Science Lab's Visual Diff guide.

You can see sample images that this will generate at this this commit


Currently, a Unix or Linux based OS, with Git, GerbV, and Eagle all placed in the system path. If you don't have Eagle in the path, you can edit the pre-commit file to add it in manually.

ImageMagick is optional, but handy.

For best usage, it's highly encouraged to also share your board on GitHub, as their visual diff tool is stellar as well.


Copy the pre-commit and post-commit files into your .git/hooks folder, and optionally edit the pre-commit file to include any pathnames. You'll also want to run mkdir gerber-previews and git add gerber-previews, since the script won't do this automatically.