# git maildiff
> **maildiff** is a simple git command to email diff in color to reviewer/ co-worker.
Navigate to git-maildiff directory you cloned or downlaoded from terminal
pip install .
where . refers to your current working directory i.e. inside git-maildiff
and you are good to go.
pip uninstall maildiff
git config --global maildiff.mailto firstname.lastname@example.org
git config --global maildiff.smtpserver smtp.gmail.com
git config --global maildiff.smtpserverport 587
git config --global maildiff.mailFrom email@example.com
git config --global maildiff.smtpencryption tls
e.g. Gmail uses tls encryption
if you forget to run the above setup the git maildiff command will prompts each
one by one and update in .gitconfig the email password is stored in OS keychain.
**git maildiff** - Email the diff of commited or uncommited changes in colored to multiple recipients and allows attaching patches.
**git maildiff -d 'HEAD^1'** - will email the diff.
when no -diff or -d flag is passed with value the default value is **git diff HEAD^ HEAD**
**git maildiff -to firstname.lastname@example.org** - will email diff to this email address.
**git maildiff -v** - use the -v flag to enable verbosity and display what command is run and what is the result of executed command.
**type git maildiff -h** in shell for more help.
If you are behind a proxy server, and you are having issues accessing git repository you can update gitconfig to add
proxy settings like
git config --global http.proxy http://mydomain\\myusername:mypassword@myproxyserver:8080
**colorama** (for windows only)
######Type **git maildiff -h** for help in command line/ terminal
**Website:** [www.devilsan.com](http://www.devilsan.com "click to got to website")
[![Licence]( http://i.creativecommons.org/l/by-nc-sa/4.0/80x15.png )](https://raw.github.com/sanfx/git-maildiff/master/LICENSE)
TODO: Brief introduction on what you do with files - including link to relevant help section.