https://github.com/filp/psdiff
Git hook to automagically render .PSD files to images, allowing you to visually diff changes.
https://github.com/filp/psdiff
Last synced: 9 months ago
JSON representation
Git hook to automagically render .PSD files to images, allowing you to visually diff changes.
- Host: GitHub
- URL: https://github.com/filp/psdiff
- Owner: filp
- Created: 2014-02-21T13:23:46.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2015-01-05T21:05:36.000Z (about 11 years ago)
- Last Synced: 2025-04-02T08:11:17.616Z (9 months ago)
- Language: Ruby
- Homepage: http://filp.github.io/psdiff
- Size: 8.14 MB
- Stars: 411
- Watchers: 19
- Forks: 15
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# psdiff
**http://filp.github.io/psdiff**
*psdiff* uses git hooks and the lovely [psd.rb](https://github.com/layervault/psd.rb)
library to automagically generate up-to-date image files from PSDs in the repository,
allowing you to easily preview them and make use of github's image diff tools.
[
**[Check out an example diff](https://github.com/filp/psdiff/commit/44b6b0466fe707396cfd6c771e5d744025e66196?diff-0=1-42)**
](https://github.com/filp/psdiff/commit/44b6b0466fe707396cfd6c771e5d744025e66196?diff-0=1-42)
```bash
filp@filp-x ~/dev/myproject
> $ git status
## master
A mock.psd
filp@filp-x ~/dev/myproject
> $ git commit -m "Add mock.psd"
psdiff: created mock.psd.png # <----------
[master 1156ea5] Add mock.psd
2 files changed, 0 insertions(+), 0 deletions(-)
create mode 100644 1.psd
create mode 100644 1.psd.png
```
That's it!
## Update: Github now supports PSD viewing!
Check it: [Github Blog - PSD Viewing & Diffing](https://github.com/blog/1845-psd-viewing-diffing)
This tool will remain available as it still possibly has its uses outside Github.
## How do I install this?
Glad you asked! Couldn't be easier. Just run this in the root of a git repo:
```
bash <(curl -sSL https://raw.github.com/filp/psdiff/master/install.sh)
```
Here's what that script does:
1. Scolds you if you don't have Ruby installed (it's required!)
2. Checks if the `psd` gem is installed and allows you to install it if needed.
3. Downloads the `pre-commit` hook from this repo to your `.git/hooks`.
Congrats! Any changes you make to psd files in the repository will now trigger psdiff!
### Warning
It's **not really** a good idea to keep large PSD files in your repositories - this project
is partially a proof-of-concept, and partially a helper for existing projects.
If you're a designer looking for a version control solution, check out
[LayerVault](https://layervault.com)
## Author
This tiny library was developed by [Filipe Dobreira](https://github.com/filp) and [Gabriele Cirulli](https://github.com/gabrielecirulli)