/electron-mattermost

Electron-based desktop application for Mattermost (https://github.com/mattermost/platform)

Primary LanguageJavaScriptMIT LicenseMIT

electron-mattermost

Circle CI

Electron-based desktop application for Mattermost

Features

Desktop integration

  • Tabs for multiple teams
  • Notifications
    • Desktop Notification
    • Badges for unread channels
  • Resident application

Pre-packaged

You don't have to install any other software.

Usage

Installation

Detailed guides are available at docs/setup.md.

  1. Download and unarchive a file from release page.
  2. Launch electron-mattermost in the unarchived folder.
  3. After first launching, please input name and URL for your Mattermost team. For example, myteam : http://mattermost.example.com/team.

Quit

Ctrl or Command + Q to quit.

Configuration

You can show the dialog from menu bar. (On Windows, please press Alt key to show the menu bar.)

Configuration will be saved into Electron's userData directory:

  • %APPDATA%\electron-mattermost on Windows
  • ~/Library/Application Support/electron-mattermost on OS X
  • ~/.config/electron-mattermost on Linux

Testing and Development

Node.js is required to test this app.

Simple testing

  1. Clone or download the source code.
  2. Run npm install.
  3. Run npm start.

When you edit .jsx files, please execute npm run build before npm start.

Development

npm run serve

Reload the app automatically when you have saved source codes.

npm test

Run tests with Mocha.

Packaging

You can package this app with following commands. Packages will be created in release directory.

$ npm run package (for your platform)
$ npm run package:windows (Requires Windows or Wine)
$ npm run package:osx (Requires OS X or Linux)
$ npm run package:linux
$ npm run package:all (Packages for all platform)