aaron/mattermost-desktop
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
custom mattermost desktop application
2244 commits 1 branch 94 tags 43 MiB
TypeScript 54.2%
JavaScript 38.1%
SCSS 4.2%
CSS 2.3%
Shell 0.9%
Other 0.1%
Go to file
Carrie Warner (Mattermost) 90202f1fbe
MM-41988 Updated links to legacy domain about.mm.com (#2003) 
* Updated links to legacy domain about.mm.com

* Updated links to legacy domain about.mm.com

* Update README.md

* Legacy domain URL updates (#2012)

* Update .github/ISSUE_TEMPLATE/troubleshooting-question.md

Co-authored-by: Harrison Healey <harrisonmhealey@gmail.com>

Co-authored-by: Harrison Healey <harrisonmhealey@gmail.com>
2022-03-10 16:40:06 -05:00
.circleci MM-41988 Updated links to legacy domain about.mm.com (#2003) 2022-03-10 16:40:06 -05:00
.github MM-41988 Updated links to legacy domain about.mm.com (#2003) 2022-03-10 16:40:06 -05:00
.vscode [MM-39839] Changes for writing unit tests, some re-org (#1849) 2021-11-04 11:29:32 -04:00
e2e [MM-18552] Autoupdater (#1714) 2022-03-08 11:38:38 -05:00
resources/windows [MM-18552] Autoupdater (#1714) 2022-03-08 11:38:38 -05:00
scripts MM-41988 Updated links to legacy domain about.mm.com (#2003) 2022-03-10 16:40:06 -05:00
src MM-41988 Updated links to legacy domain about.mm.com (#2003) 2022-03-10 16:40:06 -05: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 Code cleanup, update eslint from webapp, add ts-prune (#1884) 2021-12-03 16:01:49 -05:00
.eslintrc.json [MM-18552] Autoupdater (#1714) 2022-03-08 11:38:38 -05:00
.gitignore [MM-18552] Autoupdater (#1714) 2022-03-08 11:38:38 -05: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 MM-41988 Updated links to legacy domain about.mm.com (#2003) 2022-03-10 16:40:06 -05:00
electron-builder.json [MM-18552] Autoupdater (#1714) 2022-03-08 11:38:38 -05:00
entitlements.mac.plist Use build/ as CircleCI workspace (#1810) 2021-10-14 17:19:44 -04:00
ISSUE_TEMPLATE.md [MM-40632] Updates to the Developer Documentation and README, remove unnecessary files and code (#1922) 2021-12-17 15:00:35 -05:00
LICENSE.txt Change app author to Mattermost 2017-07-10 22:19:37 +09:00
NOTICE.txt Update NOTICE.txt (#1749) 2021-09-22 11:38:26 -04:00
package-lock.json [MM-18552] Autoupdater (#1714) 2022-03-08 11:38:38 -05:00
package.json MM-41988 Updated links to legacy domain about.mm.com (#2003) 2022-03-10 16:40:06 -05:00
PULL_REQUEST_TEMPLATE.md MM-41988 Updated links to legacy domain about.mm.com (#2003) 2022-03-10 16:40:06 -05:00
README.md [MM-40632] Updates to the Developer Documentation and README, remove unnecessary files and code (#1922) 2021-12-17 15:00:35 -05:00
SECURITY.md MM-41988 Updated links to legacy domain about.mm.com (#2003) 2022-03-10 16:40:06 -05:00
TESTING.md [MM-40632] Updates to the Developer Documentation and README, remove unnecessary files and code (#1922) 2021-12-17 15:00:35 -05:00
tsconfig.json Migrate app to TypeScript (#1637) 2021-06-28 09:51:23 -04:00
webpack.config.base.js [MM-18552] Autoupdater (#1714) 2022-03-08 11:38:38 -05:00
webpack.config.main.js [MM-41559] Dynamically size URL view to avoid overlapping bottom links (#1991) 2022-02-04 11:05:06 -05:00
webpack.config.renderer.js Make WEBSERVER_PORT configurable with env variable (#1950) 2022-01-14 14:39:17 -05:00
webpack.config.test.js Make WEBSERVER_PORT configurable with env variable (#1950) 2022-01-14 14:39:17 -05:00

README.md

Mattermost Desktop

Mattermost is an open source platform for secure collaboration across the entire software development lifecycle. This repo is for the native desktop application that's built on Electron; it runs on Windows, Mac, and Linux.

Originally created as "electron-mattermost" by Yuya Ochiai.

mm-desktop-screenshot

Circle CI

Features

Desktop integration

  • Server dropdown for access to multiple teams
  • Dedicated tabs for Channels, Boards and Playbooks
  • Desktop Notifications
  • Badges for unread channels and mentions
  • Deep Linking to open Mattermost links directly in the app
  • Runs in background to reduce number of open windows

Usage

Installation

Detailed guides are available at docs.mattermost.com.

  1. Download a file from the downloads page or from the releases page.
  2. Run the installer or unzip the archive.
  3. Launch Mattermost from your Applications folder, menu, or the unarchived folder.
  4. On the first launch, please enter a name and URL for your Mattermost server. For example, https://mattermost.example.com.

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

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.

Development and Making Contributions

Our developer guide has detailed information on how to set up your development environment, develop, and test changes to the Desktop App.