custom mattermost desktop application
Go to file
Kyriakos Z 9ce5cb759d
MM-36234: CRT, handle click on notification (#1699)
Clicking on a notification that regards a reply to a thread,
and when the user has CRT set to ON, should open the corresponding thread.

This is done by passing the URL to push to the browser along side the
notification.

Webapp: If a `url` is passed it will be used, otherwise the URL pushed to
history would be the corresponding channel (as is right now).
2021-08-19 17:36:07 +03:00
.circleci [MM-36428][MM-36434][MM-36435] Keyboard navigation and menu updates for new tab/dropdown layout (#1695) 2021-08-16 09:17:45 -04:00
.github add beta template (#1561) 2021-04-22 17:57:25 +02:00
.vscode Fix Mocha debug config 2019-03-12 23:45:52 +09:00
build [MM-31987] Allow camera use for jitsi (#1443) 2021-01-18 22:43:13 +01:00
docs [MM-23067] Browser View (#1514) 2021-03-18 15:51:53 +01:00
resources/windows Update icons (#1545) 2021-04-16 19:29:40 +02:00
scripts [MM-36423][MM-36427] Edit/Delete modals for dropdown (#1682) 2021-08-09 12:04:27 -04:00
src MM-36234: CRT, handle click on notification (#1699) 2021-08-19 17:36:07 +03:00
test Migrate app to TypeScript (#1637) 2021-06-28 09:51:23 -04:00
.editorconfig [MM-23067] Browser View (#1514) 2021-03-18 15:51:53 +01:00
.eslintignore Fix tests 2017-03-06 21:31:17 +09:00
.eslintrc-webapp.json [MM-23067] Browser View (#1514) 2021-03-18 15:51:53 +01:00
.eslintrc.json Migrate app to TypeScript (#1637) 2021-06-28 09:51:23 -04:00
.gitignore [MM-23067] Browser View (#1514) 2021-03-18 15:51:53 +01:00
babel.config.js Migrate app to TypeScript (#1637) 2021-06-28 09:51:23 -04:00
CHANGELOG.md Update CHANGELOG.md (#1089) 2019-10-24 00:12:02 +02:00
CONTRIBUTING.md Update CONTRIBUTING.md 2018-05-25 00:05:47 +09:00
electron-builder.json [MM-37661][MM-29878] Brand Updates for Desktop v5.0/MM v6.0 (#1691) 2021-08-11 16:49:36 -04: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.txt (#1573) 2021-04-29 17:37:28 +02:00
package-lock.json fix package lock (#1692) 2021-08-11 12:22:13 -04:00
package.json Remove old src/node_modules on clean if it exists (#1693) 2021-08-11 12:02:30 -04: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 (#1641) 2021-06-29 17:30:20 +02:00
SECURITY.md MM-20627: Create SECURITY.md (#1145) 2020-01-09 11:41:25 +02:00
TESTING.md Update TESTING.md 2017-11-17 11:31:35 -05:00
tsconfig.json Migrate app to TypeScript (#1637) 2021-06-28 09:51:23 -04:00
webpack.config.base.js allow webpack to resolve .json (#1672) 2021-07-26 15:43:02 +02:00
webpack.config.main.js [MM-36421] Replace server tabs with dropdown menu (#1647) 2021-07-07 18:49:48 -04:00
webpack.config.renderer.js [MM-36423][MM-36427] Edit/Delete modals for dropdown (#1682) 2021-08-09 12:04:27 -04:00
webpack.config.test.js Migrate app to TypeScript (#1637) 2021-06-28 09:51:23 -04: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 a 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.