custom mattermost desktop application

Go to file

Yuya Ochiai c85578da4f Update README.md		2016-07-24 23:17:25 +09:00
circle	Merge branch 'master' into dev	2016-06-17 23:39:45 +09:00
docker	Use electronuserland/electron-builder image in CircleCI	2016-06-10 00:07:56 +09:00
docs	Update docs	2016-07-06 22:32:40 +09:00
resources	Add clicked icons	2016-06-12 20:51:43 +09:00
script	Override author of dist/package.json	2016-06-15 00:19:44 +09:00
src	Fix Windows 10 desktop notifications have black Mattermost logo	2016-07-24 22:26:28 +09:00
test	implements #122 , urgent hint on linux	2016-07-23 14:03:53 +02:00
.editorconfig	Force to use LF and add editorconfig	2016-02-26 00:07:04 +09:00
.gitignore	Use webpack to build	2016-02-09 20:31:37 +09:00
CHANGELOG.md	Update README.md	2016-07-24 23:17:25 +09:00
circle.yml	Remove CircleCI deployment task triggered by tag	2016-07-13 01:51:27 +09:00
CONTRIBUTING.md	Add request to update CHANGELOG.md and docs/*.md	2016-07-01 01:00:11 +09:00
gulpfile.js	Use the product name "Mattermost" as file description on Windows	2016-06-27 23:11:22 +09:00
ISSUE_TEMPLATE.md	Proposed tweaks to issue template	2016-06-29 21:25:56 -07:00
LICENSE	Propose updating to Apache v2	2016-06-01 07:46:07 -07:00
package.json	Update version to 1.3.0	2016-07-07 22:38:08 +09:00
PULL_REQUEST_TEMPLATE.md	Update issue templates	2016-06-16 21:31:03 +09:00
README.md	Implement installers via electron-builder	2016-05-20 22:58:32 +02:00
TESTING.md	Fixing incorrect reference to Android device	2016-03-13 08:44:47 -07:00

README.md

Mattermost Desktop (beta)

Native desktop application for Mattermost running on Windows, Mac and Linux.

Originally created as "electron-mattermost" by Yuya Ochiai. Developed using Electron.

Features

Desktop integration

Tabs for multiple teams across multiple servers
Desktop Notifications
- Windows 10: Toast
- Windows 7-8.1: Balloon (fallback behavior, so lesser support)
- OS X: Notification Center
- Linux: libnotify
Badges for unread channels and mentions
Installs as native application

Pre-packaged

You don't have to install any other software. Packages are available on the releases page.

Usage

Installation

Detailed guides are available at docs/setup.md.

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

Quit

Ctrl or Command + Q to quit.

Configuration

You can show the dialog from menu bar. (Please press Alt key to show the menu bar if it disappers.)

Configuration will be saved into Electron's userData directory:

%APPDATA%\Mattermost on Windows
~/Library/Application Support/Mattermost on OS X
~/.config/Mattermost on Linux

When you upgrade from electron-mattermost, please copy config.json from electron-mattermost. Otherwise, you have to configure again.

Proxy

Normally, the application will follow your system settings to use proxy. Or you can set proxy by following command line options.

--proxy-server=<SERVER>:<PORT>
--proxy-pac-url=<URL>

Testing and Development

Node.js is required to test this app.

Simple testing

Clone or download the source code.
Run npm install.
Run npm start.

When you edit src/** files, please execute npm run build before npm start.

Development

`npm run watch`

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)

Create a windows installer with the following command. It will appear in the release\windows-installer directory.

$ npm run installer

Contributing

Please see CONTRIBUTING.md.