github-notifier

Summary:

Real-time notifications from github and github enterprise instances in your desktop.

Supported for OS X Yosemite and newer versions

Instructions for installation and usage

https://sargsyan.github.io/github-notifier/install.html

Instructions for playing with source code

Prerequisites

Make sure that you have jq command installed. jq is needed to github API response parsing.

Installation

To install the application run

make install

It will post files needed to scheduled run into /Library/LaunchDaemons files of MacOS.

If you want to revert the actions of install then run

make uninstall

Configurations

The application is designed to run for multiple github instances on the same time.One instance is github.com the others are github enterprise instances. Generally you will need to have one or two configurations. You can list, create, remove, activate and deactivate configurations. to get the help for configure.sh just run.

./configure.sh

Testing

If something is not working in your system and you are sure that configurations are correct you can run unit tests for your system to see if system behaves correctly. For this you need to install test framework shell scripts and run unit tests locally

brew install shunit2
make test

Troubleshooting

To check the daemon logs for the error use

tail -f /var/log/system.log

if the system logs tell that the application keeps exiting with non-zero exit codes, you can check the service logs in the ~/Library/Logs/github_notif/service.log file or locate github_notif folder in Mac OSX Console application.