https://github.com/emsk/redmine-notifier

Updated issues checker for Redmine
https://github.com/emsk/redmine-notifier

electron redmine

Last synced: 28 days ago
JSON representation

Updated issues checker for Redmine

• Host: GitHub
• URL: https://github.com/emsk/redmine-notifier
• Owner: emsk
• License: mit
• Created: 2015-12-13T10:58:40.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2023-01-04T14:30:30.000Z (over 2 years ago)
• Last Synced: 2024-04-14T22:20:23.755Z (about 1 year ago)
• Topics: electron, redmine
• Language: JavaScript
• Homepage:
• Size: 3.69 MB
• Stars: 33
• Watchers: 8
• Forks: 5
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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)