README.md
# Redmine Notifier
[![Build Status](https://travis-ci.org/emsk/redmine-notifier.svg?branch=main)](https://travis-ci.org/emsk/redmine-notifier)
[![Code Climate](https://codeclimate.com/github/emsk/redmine-notifier/badges/gpa.svg)](https://codeclimate.com/github/emsk/redmine-notifier)
[![Inline docs](http://inch-ci.org/github/emsk/redmine-notifier.svg?branch=main)](http://inch-ci.org/github/emsk/redmine-notifier)
[![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/sindresorhus/xo)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
Redmine Notifier is a simple updated issues checker that runs in the background.
It sends a desktop notification if there are any updates in issues.
## Installation
Installers for macOS and Windows can be found on the [releases](../../releases) page.
For Windows, the app is installed to `C:\Users\[UserName]\AppData\Local\redmine\app-[AppVersion]\Redmine Notifier.exe`.
## Main Notifications
The number of issues that were updated after previous fetch is shown in parentheses.
Also, the subject is shown only about the latest issue.
![Notification Mac 10.10](examples/notification_osx_10.10.png?raw=true)
![Notification Win 10](examples/notification_win_10.png?raw=true)
## Sub Notifications
When Redmine Notifier is started, an icon appears in the menu bar or task tray.
If there is a notification in the most recent fetch, the icon is replaced by the notification icon.
##### Menu Icon (macOS)
Normal: ![Icon Mac Normal](examples/icon_osx_normal.png?raw=true) Notification: ![Icon Mac Notification](examples/icon_osx_notification.png?raw=true)
##### Tray Icon (Windows)
Normal: ![Icon Win Normal](examples/icon_win_normal.png?raw=true) Notification: ![Icon Win Notification](examples/icon_win_notification.png?raw=true)
## Settings
Open the context menu and select "Preferences".
![Settings](examples/redmine_notifier_settings.png?raw=true)
## Development
Redmine Notifier is powered by [Electron](http://electron.atom.io/), so we can develop it with web technologies.
### Dependencies
##### Production
* [node-notifier](https://github.com/mikaelbr/node-notifier)
* [notie](https://github.com/jaredreich/notie)
##### Development
* [ava](https://github.com/avajs/ava)
* [electron](https://github.com/electron/electron)
* [electron-builder](https://github.com/electron-userland/electron-builder)
* [spectron](https://github.com/electron/spectron)
* [stylelint](https://github.com/stylelint/stylelint)
* [stylelint-config-standard](https://github.com/stylelint/stylelint-config-standard)
* [textlint](https://github.com/textlint/textlint)
* [textlint-rule-write-good](https://github.com/nodaguti/textlint-rule-write-good)
* [xo](https://github.com/sindresorhus/xo)
See `dependencies` and `devDependencies` in [`package.json`](package.json).
### Installing dependencies
```sh
cd /path/to/redmine-notifier
yarn install
```
### Starting app
```sh
yarn start
```
### Building installers
```sh
yarn run pack
```
### Linting JavaScript, CSS, and Markdown files
```sh
yarn run lint
```
### Testing app
```sh
yarn test
```
See `scripts` in [`package.json`](package.json) with regard to other commands.
## Contributing
1. Fork it ( https://github.com/emsk/redmine-notifier/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request
## Related
* [Redmine Now](https://github.com/emsk/redmine-now) - A desktop app to know what's happening now on your Redmine
## License
[MIT](LICENSE)