custom mattermost desktop application
Go to file
Dean Whillier 00de500906 change mechanism for showing/hiding tabs (#1057)
- allow hidden tabs to still receive unread/mention updates
2019-10-08 22:25:03 +02:00
.circleci Add msi, gpo, new CI and runtime/sandbox hardening 2019-10-01 14:10:25 +02:00
.github/ISSUE_TEMPLATE Update bug_report.md 2018-05-22 09:37:47 -04:00
.vscode Fix Mocha debug config 2019-03-12 23:45:52 +09:00
docs Optimize png image with zopflipng lossless compression (#981) 2019-07-09 21:29:02 -04:00
resources Add msi, gpo, new CI and runtime/sandbox hardening 2019-10-01 14:10:25 +02:00
scripts Add msi, gpo, new CI and runtime/sandbox hardening 2019-10-01 14:10:25 +02:00
src change mechanism for showing/hiding tabs (#1057) 2019-10-08 22:25:03 +02:00
test [MM-18152] Desktop notifications (#1040) 2019-09-23 14:59:12 -04:00
.editorconfig Force to use LF and add editorconfig 2016-02-26 00:07:04 +09:00
.eslintignore Fix tests 2017-03-06 21:31:17 +09:00
.eslintrc-webapp.json [MM-14740] Consolidate configuration to support integration of MSI/GPO (#959) 2019-04-11 13:58:30 +02:00
.eslintrc.json [MM-14740] Integrate GPO functionality (#961) 2019-04-18 13:19:04 -04:00
.gitignore Switch back from yarn to npm 2019-01-07 23:32:01 +09:00
babel.config.js Upgrade babel, webpack and storybook stack 2018-12-04 23:35:14 +09:00
CHANGELOG.md Update CHANGELOG.md (#1017) 2019-08-09 12:33:50 -07:00
CONTRIBUTING.md Update CONTRIBUTING.md 2018-05-25 00:05:47 +09:00
electron-builder.json Add msi, gpo, new CI and runtime/sandbox hardening 2019-10-01 14:10:25 +02:00
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md (#930) 2019-04-10 20:42:29 -04:00
LICENSE.txt Change app author to Mattermost 2017-07-10 22:19:37 +09:00
NOTICE.txt Update NOTICE file with electron version and new 'winreg' dependency 2019-05-11 23:35:46 +02:00
package-lock.json Bump mixin-deep from 1.3.1 to 1.3.2 (#1027) 2019-09-20 16:33:16 +02:00
package.json Add msi, gpo, new CI and runtime/sandbox hardening 2019-10-01 14:10:25 +02:00
PULL_REQUEST_TEMPLATE.md Update PULL_REQUEST_TEMPLATE.md for eslint 2016-11-07 22:00:21 +09:00
README.md Update README.md (#960) 2019-04-18 12:37:20 -04:00
TESTING.md Update TESTING.md 2017-11-17 11:31:35 -05:00
webpack.config.base.js Add eslint-plugin-eslint-comments 2019-03-12 23:31:45 +09:00
webpack.config.main.js Add eslint-plugin-eslint-comments 2019-03-12 23:31:45 +09:00
webpack.config.renderer.js Add eslint-plugin-eslint-comments 2019-03-12 23:31:45 +09:00

Mattermost Desktop

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

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

screenshot_20

Circle CI

Features

Desktop integration

  • Tabs for multiple teams across multiple servers
  • Desktop Notifications
    • Windows 10: Toast
    • Windows 7-8.1: Popup like Toast
    • 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.mattermost.com.

  1. Download a file from the downloads page.
  2. Launch Mattermost in the unarchived folder.
  3. On the first launch, please input name and URL for your Mattermost server. For example, myserver : https://mattermost.example.com.

Quit

Ctrl or Command + Q to quit.

Configuration

You can show the dialog from menu bar.

Configuration will be saved into Electron's userData directory:

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

A custom data directory location can be specified with:

  • Mattermost.exe --args --data-dir C:\my-mattermost-data on Windows
  • open /Applications/Mattermost.app/ --args --data-dir ~/my-mattermost-data/ on macOS
  • ./mattermost-desktop --args --data-dir ~/my-mattermost-data/ 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 a proxy, or you can set up a proxy by the following command line options.

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

On Windows, please make sure to add -- before options. For example, Mattermost.exe -- --proxy-server=....

Custom App Deployments

Our docs provide a guide on how to customize and distribute your own Mattermost Desktop App, including how to distribute the official Windows Desktop App silently to end users, pre-configured with the server URL and other app settings.

Contributing

Please see CONTRIBUTING.md.

Development

Please see docs/development.md.