Desktop application changelog
Available on all plans
Cloud and self-hosted deployments
Latest Mattermost Desktop App releases:
Release v5.2
v5.2.2, released 2022-12-06
Added ARM64 build (beta) for Windows/Linux.
Fixed an issue on Windows installers where the onboarding screen was displayed even when there was a preconfigured server list MM-48079.
Fixed an issue where a crash could occur when a download list included corrupt data MM-48483.
Fixed an issue where
AppImageLauncher
still created a bad shortcut that caused the app not to launch MM-48557.Fixed an issue where notifications were not displayed on Windows v8 and v8.1 MM-48397.
Fixed an issue where users could get stuck after finished the Getting Started flow MM-48682.
Fixed an issue where the window resize did not work on some windows machines MM-48574.
Fixed an issue on Windows where the three-dot menu remained focused after clicking elsewhere MM-46424.
v5.2.1, released 2022-11-15
Fixed an issue on
.exe
installers where the onboarding screen was still displayed even when there was a preconfigured server list MM-48079.Fixed an issue where the default downloads location was not set on macOS MM-48167.
Fixed an issue where users were able to edit or remove a pre-configured server provided by GPO on Windows MM-48184.
Fixed an issue where the tray icon colour on Windows didn’t obey the setting MM-48080.
v5.2.0, released 2022-10-31
Original v5.2.0 release
Download Binaries: Mattermost Desktop on GitHub
Compatibility
Desktop App is supported on any supported Extended Support Release or a newer Mattermost server version.
Highlights
Onboarding screen improvements: Added new Configure Server and first user onboarding screens when starting the app without servers configured.
Added a Downloads dropdown menu that displays file upload progress and recently downloaded files.
Improvements
All Platforms
The Desktop App configured URL is now forced to be changed to the SiteURL configured by the system adminstrator.
Added localization support to the Desktop App (Beta).
Zoom in/out now works when
CTRL/CMD+SHIFT+=
is pressed.Changed the order of fields in the Add Server modal so that the server URL is filled in first and the display name after.
The app window now reloads only when the URL changes, not when a server’s name changes.
Updated the default window size to 1280x800, so that users can now see other login options as well on first load.
Swapped the dark and light theme tray icons on Linux and Windows to the expected behavior.
Disabled the auto-update functionality explicitly for all MSI installers except the Windows EXE installer and the Linux AppImage.
Dropped support for asterisk-based unreads in Mattermost Self-Hosted versions older than v5.28.
Improved the performance of window resizing.
Architectural Changes
Major version upgrade of Electron to v21.2.0. Electron is the underlying technology used to build the Desktop App.
Bug Fixes
Linux
To fix notification issues for Linux users, the configuration setting
notifications.flashWindow
default value was changed to0
for Linux.
All Platforms
Fixed an issue where an Operating System could register Mattermost as the default web browser / mail app.
Fixed an issue where the download notification showed the wrong file name.
Fixed an issue where it was possible to drag the Minimize/Close buttons.
Fixed an issue where a misleading error message from a remote certificate would imply that the Mattermost server had an issue.
Fixed an issue where users still received notifications when their status was set to Do Not Disturb.
Fixed an issue where users could not replace files in the Downloads folder.
Fixed improper reporting of app version when the
--version
or-v
command-line flags were passed.Fixed an issue where MAS users couldn’t easily replace files.
Open Source Components
Added
macos-notification-state
,windows-focus-assist
, andreact-intl
to https://github.com/mattermost/desktop.
Known Issues
Users seeing an endless “Loading…” screen when attempting to log in to the app may need to manually remove their cache directory. For MacOS it is located in
/Users/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost
and for Windows it is located inUsers/<username>/AppData/Roaming/Mattermost
.On Linux, a left click on the tray icon doesn’t open the app window but opens the tray menu.
Crashes might be be experienced in some Linux desktop clients. This is an upstream bug in the
libnotifyapp
library. A recommended workaround is to disable the system tray icon in the Desktop settings.On apps using GPO configurations, when adding a second server tab, it’s possible to drag and drop tabs, but they’ll jump back to the original position when releasing the mouse.
Release v5.1
v5.1.1, released 2022-06-27
Upgraded to Electron v18.3.0.
Fixed an issue where a channel name matching the server subpath would not be navigable.
Fixed an issue where the
hideOnStart
setting didn’t work.Fixed an issue where the certificate error dialog box would reappear infinitely.
Fixed an issue where the first client certificate could not be selected.
Restored Windows ZIP builds.
v5.1.0, released 2022-05-16
Original v5.1.0 release
Download Binaries: Mattermost Desktop on GitHub
Note: Mattermost v5.1.0 contains a low severity level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Compatibility
Desktop Apps is supported on any supported Extended Support Release or a newer Mattermost server version.
Highlights
Added a Desktop App auto-updater. The app now automatically checks for new updates on app start up. Note that the Mac builds provided on GitHub do not support auto-updates.
Improvements
Mac
Mattermost can now be installed on the Mac App Store. Even if you’re already using Mattermost desktop on Mac, you can download and install it via the Mac App Store to access future automatic updates.
Linux
Updated the Linux closing behaviour to allow the app to close complely when pressing
X
.Changed the default setting for Leave app running in notification area when application window is closed on Linux to
false
by default.
All Platforms
Added the ability in Calls to select which window to share when screensharing.
Added a new config setting “Launch app minimized” to be able to auto-launch the app minimized when the application is launched on startup.
When the Add Server modal pops up for the first time when the app is launched, the modal now stays open instead of closes on mouse click until the first server has been added.
Added a new setting/preference to always open the Desktop App in full screen.
The app now uses
ctrl+=
andcmd+=
to zoom in to match the behavior of Chrome and Firefox.Changed the wording in the File > View menu from
Tab
toServer
to reflect recent changes in the user interface.Added the ability to copy the version string into clipboard from Menu > Help > Version.
Added a menu item Window > Show Servers to show a list of servers.
Removed the reference to the flashing window on the Settings page to avoid confusion when the window doesn’t flash.
Architectural Changes
Major version upgrade of Electron to v18.0.3. Electron is the underlying technology used to build the Desktop app.
Bug Fixes
Linux
Fixed an issue where the app window and taskbar did not flash when notifications were received.
All Platforms
Fixed an issue where customized URIs were not supported on the desktop app.
Fixed an issue where parsed, but technically invalid URIs could not be opened in the browser.
Fixed an issue where a channel name with an asterisk at the front would cause unreads to return a false positive.
Fixed an issue where opening a new tab view caused the original view to go to the requested link as well.
Fixed an issue where users could add the same server name or URL twice.
Fixed an issue where the URL view prevented users from clicking a button directly above it.
Fixed an issue where the tray icon theme toggle was not hidden when the icon itself wasn’t enabled.
Fixed an issue where a redundant icon was present in Windows 10+ notifications.
Fixed an issue where unreads on a different team wouldn’t trigger an unread badge in the Desktop App.
Fixed an issue where retrying to load tabs indefinitely instead of stopping after a few tries was not supported.
Fixed issues with the loading screen to make it more reliable.
Fixed an issue where
Shift+Alt
moved the focus to the top menu.Fixed an issue where external links at the bottom of the page were not clickable.
Fixed an issue where mentions/unreads did not take precedence when setting the badge/tray icon.
Fixed an issue where the macOS dock would stay open after clicking the tray icon.
Fixed an issue where the URL view would persist once the user had moved their mouse off of an external URL.
Known Issues
On Linux, a left click on the tray icon doesn’t open the app window but opens the tray menu.
Mattermost Desktop App v5.1.0 cannot be launched twice on Windows servers with the role “Remote Desktop Session Host”.
Desktop App may become unresponsive and crash when initiating a screen reader MM-44058.
Crashes might be be experienced in some Linux desktop clients. This is an upstream bug in the
libnotifyapp
library. A recommended workaround is to disable the system tray icon in the Desktop settings.On apps using GPO configurations, when adding a second server tab, it is possible to drag and drop tabs but they will jump back to the original position when releasing the mouse.
Release v5.0
v5.0.4, release 2022-02-04
Fixed an issue where Desktop App toast notifications didn’t work in v5.0.3.
Restored Minimize to tray option for Windows, and added the ability to override the tray icon color.
v5.0.3, released 2022-02-01
Fixed an issue where a user might get an erroneous “Your session has expired” error and be unable to login.
Fixed an issue where the app could crash while trying to reload a page that is currently loading.
Fixed an issue where OS-level shortcuts could cause an unexpected focus behavior in the app.
Fixed an issue where Linux users might not see the Add Server modal.
Fixed an issue that prevented the export channel log from being downloaded from Playbooks.
v5.0.2, released 2021-11-15
Fixed an issue where the Desktop app crashed intermittently when switching between tabs while a tab was loading.
Fixed an issue where the app didn’t raise the window from the tray icon when clicking on the taskbar icon.
v5.0.1, released 2021-10-22
Fixed issue with desktop notification sounds not working correctly.
Fixed an issue where using a proxy server with the Desktop app caused the app to crash.
Fixed the new server modal not being accessible on Linux when no other servers existed.
Fixed an issue where switching from Boards/Playbooks to Channels caused a reload in the Channels view.
Fixed an issue with GPO and built-in servers not working correctly with Boards/Playbooks tabs.
Fixed an issue where the top bar buttons on Windows 8 were missing.
Reduced the size of some builds by removing unnecessary files.
v5.0.0, released 2021-10-13
Original v5.0.0 release
Download Binaries: Mattermost Desktop on GitHub
Note: Mattermost v5.0.0 contains a low level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Compatibility
Desktop Apps is supported on any supported Extended Support Release or a newer Mattermost server version.
Breaking Changes / Upgrade Notes
Some keyboard shortcuts and menu items were updated to work with the new Desktop App layout.
Ctrl+#
is used for changing tabs andCtrl+Shft+#
is used for changing servers.
Highlights
Redesigned title bar allows users to seamlessly work in Channels, Playbooks, and Boards across multiple servers with minimal context switching.
Improvements
All Platforms
Added support for multiple languages to be used by the spellchecker. This can be configured in the desktop preferences.
Updated loading screen visuals.
Added a dark mode for settings and modals.
Changed the server selection to use a dropdown instead of tabs.
Added support for dragging and dropping of the server dropdown items to re-order servers.
Converted the tabs interface to support multiple configurable tabs based on the added server to easily access Boards and Playbooks via tabs in the window header.
Removed the Server Management screen from Settings, and added Edit/Delete buttons to the new dropdown, as users can now configure and edit their servers from the server dropdown menu.
Added a checkbox to certificate error modal that allows users to permanently distrust a certificate.
Architectural Changes
Major version upgrade of Electron to v14.1. Electron is the underlying technology used to build the Desktop app.
Added a RPM build option to the Electron builder.
Added Universal binaries for MacOS users.
Migrated to Bootstrap v4 and refreshed the interface. Migrated to
react-beautiful-dnd
instead ofreact-smooth-dnd
for a cleaner experience.
Bug Fixes
Linux
Fixed the tray icon size on Linux.
Fixed an issue where pressing
Alt+<somekey>
could cause the menu bar to disable and overlap the top bar on Linux.
All Platforms
Fixed an issue where resizing the app while in the System Console caused a white bar to appear at the top.
Fixed an issue where the right-click menu was missing from the
jira connect
modal.Fixed an issue where the app would render off screen and the user would have trouble getting the window in view.
Known Issues
Unread messages icon may be missing from the taskbar on Windows following 4.7.0 upgrade MM-37807.
Crashes might be be experienced in some Linux desktop clients. This is an upstream bug in the
libnotifyapp
library. A recommended workaround is to disable the system tray icon in the Desktop settings.On some Linux distros, a sandbox setting is preventing apps from opening links in the browser (see https://github.com/electron/electron/issues/17972#issuecomment-486927073). While this is fixed for most installers, it is not on the tgz. In this case manual intervention is required via
$ chmod 4755 <installpath>/chrome-sandbox
.Pressing Enter multiple times during Basic Authentication causes a crash.
On apps using GPO configurations, when adding a second server tab, it is possible to drag and drop tabs but they will jump back to the original position when releasing the mouse.
Release v4.7
Download Binaries: Mattermost Desktop on GitHub
v4.7.2, released 2021-09-13
Upgraded to Electron v12.0.16.
Fixed an issue where the Add Server screen appeared on each startup on servers with GPO.
Fixed an issue where the window would flash on Windows and Linux when a new mention arrived regardless of the setting to turn it on/off.
Added desktop notifications for followed threads.
v4.7.1, released 2021-08-03
Mattermost v4.7.1 contains a medium level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Added support to allow users to specify a different download location for Hunspell dictionaries.
Fixed an issue where the notification badge did not get cleared when reading a channel with unread messages until navigating away from the channel.
Fixed an issue where the top bar menu, and the minimize, maximize and close icons did not work on 4.7.0 on Windows 10 if GPU acceleration was disabled.
Reverted to Electron v12.0.1 to fix an issue where clicking in the searchbox to highlight search terms dragged the desktop window.
Fixed an issue to prevent a crash on malformed default download locations.
v4.7.0, released 2021-06-23
Original v4.7.0 release
Note: Mattermost v4.7.0 contains low to medium level security fixes. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Compatibility
Desktop Apps is supported on any supported Extended Support Release or a newer Mattermost server version.
Highlights
Added support for Electron BrowserView, an underlying architecture change that improves performance and offers snappier interactions (i.e., less lag), lower CPU usage, and faster launch times.
Improvements
Windows
Windows desktop now automatically switches between light and dark themes based on the operating system settings.
All Platforms
Added a setting to specify the default desktop app download location.
Improved the launch screen and loading indicator.
Restored deeplinking.
Improved the spell check dictionary to provide more accurate spelling suggestions in more languages. The spell check language is now automatically based on the operating system setting.
Added improvements to be consistent with the use of URL and URL libraries.
Ctrl/CMD + F functionality has been replaced with in-channel search (requires Mattermost server v5.36+).
Updated the Content Security Policy for Desktop App to avoid warnings in the dev tools.
On Linux and Windows, each settings menu is now in a separate window.
Shortened the maximum length (width) for server tab names to 224px.
Updated the menu bar and system tray icons for improved contrast.
Removed
libappnotify1
as a dependency requirement in Debian installers as it’s no longer shipped in Debian’s Bullseye. It’s still recommended to install where available.
Architectural Changes
Major version upgrade of Electron to v12.0.10. Electron is the underlying technology used to build the Desktop app.
Added support for Electron BrowserView.
Added support for M1 architecture (beta) in the build pipeline.
Bug Fixes
Windows
Fixed an issue where Windows desktop notifications did not auto-dismiss when another notification arrived.
Fixed an issue on Windows where the Pin to Taskbar icon got lost during an upgrade.
Fixed an issue with the MSI build that caused notifications to not open the application and navigate to the correct channel.
MacOS
Fixed an issue where changing the theme from the System Preferences changed the tray icon, but the red/blue dot indicating unreads got removed.
Fixed an issue where there was an invisible Mattermost icon in the top menu bar.
Linux
Fixed an issue where Shift+Alt moved the focus to the main menu instead of changing keyboard layout.
All Platforms
Fixed an issue where special characters were not shown for server names using GPO.
Fixed an issue where the close/back button in permanent link media previews was missing.
Fixed an issue where the text input focus was lost when closing the Settings window.
Fixed an issue where saving the desktop app settings didn’t remove the saving indicator in the settings window.
Fixed an issue where the jewel indicating the number of mentions was not shown in the tab.
Fixed an issue where the desktop linting didn’t match the webapp linting.
Fixed an issue where clicking on a notification did nothing when the wrong server tab was selected.
Fixed an issue where users were unable to copy text from desktop About window.
Known Issues
The new spellchecker connects to Google servers for downloading updated dictionaries.
Unread messages icon may be missing from the taskbar on Windows following 4.7.0 upgrade MM-37807.
Clicking on View > Find doesn’t work MM-36606.
Right click menu is missing from the
jira connect
modal MM-36032.Search field is focused on first start of the app MM-35249.
The
create_desktop_file.sh
script is removed from the .tar.gz release. As a workaround, it can be downloaded from GitHub here.An error may occur when installing the MSI Installer on any Windows version.
Crashes might be be experienced in some Linux desktop clients. This is an upstream bug in the
libnotifyapp
library. A recommended workaround is to disable the system tray icon in the Desktop settings.On some Linux distros, a sandbox setting is preventing apps from opening links in the browser (see https://github.com/electron/electron/issues/17972#issuecomment-486927073). While this is fixed for most installers, it is not on the tgz. In this case manual intervention is required via
$ chmod 4755 <installpath>/chrome-sandbox
.Pressing Enter multiple times during Basic Authentication causes a crash.
On apps using GPO configurations, when adding a second server tab, it is possible to drag and drop tabs but they will jump back to the original position when releasing the mouse.
Release v4.6
Download Binaries: Mattermost Desktop on GitHub
v4.6.2, released 2021-01-25
v4.6.1, released 2020-10-26
Fixed an issue where desktop app notification sounds did not work on Desktop App v4.6.0. MM-29921
v4.6.0, released 2020-10-16
Original v4.6.0 release
Improvements
All Platforms
Added a setting to be able to select different desktop notification sounds (Requires Mattermost server v5.28+).
Show Mattermost icon in the menu bar
setting is now enabled by default for new installs on Mac, andShow icon in the notification area
andLeave app running in the notification area when application window is closed
settings are are now enabled by default for new installs on Ubuntu.The default window frame and server tabs are now used on older Windows and Linux OS versions.
Added Russian and Ukrainian language spellcheckers.
Added support for allowing access to managed resources.
The same default protocols as in the server are now used in the autolink plugin.
Bug Fixes
All Platforms
Fixed an issue where the app window started as maximized when the “Start app on login” setting was enabled. The Desktop App no longer shows in the system tray and the parameter
--hidden
was removed. This setting is not respected when AppImage file (Unofficial) is used.Fixed an issue where the Add server modal fields were missing the right-click menu.
Fixed an issue where users did not see the right-click menu with Copy and Paste options on the login page when using the desktop app to login to an external application.
Fixed an issue where the URL bar was shown in the bottom left corner when hovering over a timestamp or internal links.
Fixed an issue where a Javascript error occurred when a separate OAuth window was open.
Fixed an issue where users were unable to resize the desktop app vertically from the top tab bar.
Fixed an issue where some links pointing to the System Console did not work on the desktop app.
Known Issues
Unlocking the Desktop App on macOS marks the currently viewed channel as read. MM-31429
On Ubuntu, auto-focus is lost when using ALT+TAB to switch between windows. MM-29705
Crashes might be be experienced in some Linux desktop clients. This is an upstream bug in the
libnotifyapp
library and a recommended workaround is to disable the system tray icon in the Desktop settings.On some Linux distros, a sandbox setting is preventing apps from opening links in the browser (see https://github.com/electron/electron/issues/17972#issuecomment-486927073). While this is fixed for most installers, it is not on the tgz. In this case manual intervention is required via
$ chmod 4755 <installpath>/chrome-sandbox
.Pressing Enter multiple times during Basic Authentication causes a crash.
On apps using GPO configurations, when adding a second server tab, it is possible to drag and drop tabs but they will jump back to the original position when releasing the mouse.
Release v4.5
Download Binaries: Mattermost Desktop on GitHub
v4.5.4, released 2020-09-11
Fixed an issue where Help and Report a Problem website links configured to point to Mattermost channels didn’t work. MM-28595
v4.5.3, released 2020-08-25
Fixed an issue where users were unable to log in to the desktop app when users had to select a certificate for authentication that requires a pin even when there was only one option to manage a certificate login. MM-27331
v4.5.2, released 2020-07-20
Fixed an issue on Linux app started as a blank screen when both “Show icon in the notification area” and “Start app on login” were enabled. MM-26832
v4.5.1, released 2020-07-13
Mattermost v4.5.1 contains a high level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
v4.5.0, released 2020-06-16
Original v4.5.0 release
Improvements
All Platforms
Added a spell checker for Polish language.
Added support for triggering a desktop notification when a file download is complete.
Added support for the cursor focus to be on the Server Name field when clicking on the
+
tab to add a new server.Defaulted “Flash app window and taskbar icon when a new message is received” setting to
True
.
Architectural Changes
Major version upgrade of Electron to v7.0.0. Electron is the underlying technology used to build the Desktop apps.
Bug Fixes
All Platforms
Fixed an issue where the Desktop app could not authenticate with SAML with an IdP relay.
Fixed an issue where a moved server tab did not stay in focus.
Fixed an issue where right-clicking and then clicking “Save Image” didn’t work.
Fixed an issue where trusting self-signed certificates kept asking for trust.
Fixed an issue where a link to the root of a server caused a “Channel not Found” error if the URL didn’t end with a
/
.Fixed an issue where using ESC or Cancel to close the Add Server modal did not return focus to previously selected text input.
Fixed an issue where OneLogin links opened up in the app itself making it impossible to go back to the app.
Fixed an issue where links on “Cannot connect to Mattermost” error didn’t work.
Windows
Fixed an issue where Windows Desktop notifications were delayed compared to other notification channels.
Fixed an issue where Windows Desktop Menu option was read as “Unlabel 0 button”.
Fixed an issue where a white bar was present on the right-hand side of the Settings screen when Add Server modal was open.
Mac
Fixed an issue where double clicking the top bar no longer minimized or maximized the window.
Fixed an issue where users were unable to reposition the app by using click, hold and drag on the left side of the header.
Fixed an issue where server display name field lost focus when using
CMD+Tab
to navigate away and back to the app.Fixed an issue where a long server address didn’t wrap correctly in the new server settings page.
Fixed an issue where copy and pasting into Atlassian login fields pasted text in the wrong place.
Known Issues
A visible cursor focus is missing on the login screen directly after adding a new server via “+” to the right of the server tabs. MM-25984
Right-click menu is missing on “Add server” modal fields. MM-26017
Double notifications are received on Ubuntu for at-mentions. MM-26012
The current window frame and server tabs are not styled consistently with the rest of the OS in Windows 7 or Linux. MM-22751
Crashes might be be experienced in some linux desktop clients. This is an upstream bug in the
libnotifyapp
library and a recommended workaround is to disable the system tray icon in the Desktop settings.On some Linux distros, a sandbox setting is preventing apps from opening links in the browser (see https://github.com/electron/electron/issues/17972#issuecomment-486927073). While this is fixed for most installers, it is not on the tgz. In this case manual intervention is required via
$ chmod 4755 <installpath>/chrome-sandbox
.Pressing Enter multiple times during Basic Authentication causes a crash.
On apps using GPO configurations, when adding a second server tab, it is possible to drag and drop tabs but they will jump back to the original position when releasing the mouse.
Release v4.4
Download Binaries: Mattermost Desktop on GitHub
v4.4.2, released 2020-05-11
Fixed an issue on Windows where a channel was marked as read if the app was closed on a channel where the message was posted. MM-23215
v4.4.1, released 2020-04-22
Fixed an issue where the Desktop client opened to a blank white Window when using GPO-set teams. MM-23082
Fixed an issue where Google oAuth with Gmail addresses did not work on the Desktop app for plugins. MM-23057
Fixed an issue where Windows Desktop notifications were delayed. MM-22552
Fixed an issue where the app sometimes didn’t restore to the right position but “jumped” to a different place in the display when minimizing the app and then maximizing it. MM-23195
Fixed an issue where users were not able to paste text into the login screen. MM-23784
Fixed an issue where back/forward navigation on the OAuth window caused the app to crash. MM-23153
v4.4.0, released 2020-02-16
Original v4.4.0 release
Note: Mattermost v4.4.0 contains low to medium level security fixes. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Breaking Changes
Due to moving to a new configuration version to support the new tabbar for the ability to rearrange the server tab order, it is recommended to do a backup of previous config if you want to downgrade your Desktop App version afterwards.
Improvements
All Platforms
Added support for Certificate Authentication, including PIV Card authentication.
Improved server tab organization and visuals with the ability to reorder server tabs via drag-and-drop, notification updates that make it easier to tell when new messages or mentions come in, and a new dark theme.
Added a spell checker for Italian language.
Added auto focus on Server Display Name input field.
Architectural Changes
Major version upgrade of Electron to v6.0.0. Electron is the underlying technology used to build the Desktop apps.
Bug Fixes
All Platforms
Fixed an issue where downgrading the app caused login issues.
Fixed an issue where Ctrl+C or Ctrl+V didn’t work on Electron modals or developer tools.
Fixed an issue where navigation with Ctrl/Cmd+Tab stopped on disconnected server.
Fixed an issue where a new desktop window was created after clicking on a permalink to a channel on a different server.
Fixed an issue where changing the spellchecker on the app did not suggest words in that language.
Fixed an issue where the app window didn’t save “floating” app position.
Fixed an issue where copying and pasting into Atlassian login fields pasted text in the wrong place.
Known Issues
The current window frame and server tabs are not styled consistently with the rest of the OS in Windows 7 or Linux. MM-22751
No notification on Windows if the app is closed on the channel where the message is posted. MM-23215
Crashes might be be experienced in some linux desktop clients. This is an upstream bug in the
libnotifyapp
library and a recommended workaround is to disable the system tray icon in the Desktop settings.On some Linux distros, a sandbox setting is preventing apps from opening links in the browser (see https://github.com/electron/electron/issues/17972#issuecomment-486927073). While this is fixed for most installers, it is not on the tgz. In this case manual intervention is required via
$ chmod 4755 <installpath>/chrome-sandbox
.Pressing Enter multiple times during Basic Authentication causes a crash.
The confirmation dialog from UAC names MSI installers with random numbers.
On apps using GPO configurations, when adding a second server tab, it is possible to drag and drop tabs but they will jump back to the original position when releasing the mouse.
Release v4.3
Download Binaries: Mattermost Desktop on GitHub
v4.3.2, released 2019-11-29
Mattermost v4.3.0 contains a low level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Fixed an issue where the app started into white screen after a system reboot on Windows. MM-19649
Fixed an issue where CMD+Z didn’t undo on the Mac desktop app. MM-19198
Fixed an issue where users were unable to zoom in/out except on the first server tab. MM-19032
Fixed an issue where right-click + “Copy” did not work in some instances. MM-19324
Fixed an issue where email links in profile popovers didn’t work. MM-19596
v4.3.1, released 2019-10-22
Fixed an issue where Mac desktop app was not notarized correctly for installing on MacOS Catalina. MM-19555
v4.3.0, released 2019-10-17
Original v4.3.0 release
Note: Mattermost v4.3.0 contains medium level security fixes. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Breaking Change
The Mattermost Desktop v4.3.0 release includes a change to how desktop notifications are sent from non-secure URLs (http://). Organizations using non-secure Mattermost Servers (http://) will need to update to Mattermost Server versions 5.16.0+, 5.15.1, 5.14.4 or 5.9.5 (ESR) to continue receiving desktop notifications when using Mattermost Desktop v4.3.0 or later.
Improvements
All Platforms
Added support for maintaining a user’s online status while the desktop app is in the background but the user is interacting with their computer. Requires Mattermost Server v5.16.0, v5.15.1, v5.14.4 or later.
Updated spellchecker dictionaries for English.
Added support for exposing Webview Developer Tools via View Menu.
Improved the styling of the session expiry mention badge in the tab bar.
Improved the wording of the invalid certificate dialog.
Improved accessibility support for the menu bar items.
Windows
Added support for MSI installer (Beta) to allow deploying Mattermost desktop app to the computer program files (accessible by any user accounts rather than a specific user account on the machine).
Added support for Group Policies (GPO) to allow admins to set default servers and enable/disable the ability to add/remove servers.
Architectural Changes
Major version upgrade of Electron to v5.0.0. Electron is the underlying technology used to build the Desktop apps.
Bug Fixes
All Platforms
Fixed an issue where opening the emoji picker froze the desktop app.
Fixed an issue where jumbo emoji didn’t render for unsupported unicode emojis.
Fixed an issue where username and password were not being passed for HTTP basic authentication.
Fixed an issue where switching server tabs on app load caused a visual size glitch.
Fixed various desktop app notification issues.
Fixed an issue where the unread count changed after opening the quick switcher.
Fixed an issue where clicking on some links in System Console opened the links on the app itself.
Fixed an issue where the “Help” button opened in a new browser tab instead of below the textbox in the default system browser.
Fixed an issue where Mattermost opened both on fullscreen and on a smaller window when closing the app in fullscreen.
Fixed an issue to prevent the app from restarting in full-screen mode.
Fixed an issue where the dot and mention counts in server tab jewels were not centered.
Fixed an issue where the dot in notification badges was off centre.
Known Issues
Users are unable to zoom in/out on the desktop app. This bug will be fixed after a major version upgrade of Electron to v6.0.0.
CMD+Z
doesn’t undo on the Mac desktop app.Unable to exit full screen Youtube videos.
“RIght-click + Copy” does not work.
Notifications appear in sequence rather than stacking on Windows.
Clicking on notifications when using the MSI installer(s) doesn’t focus the app or the channel that triggered the notification.
Release v4.2.3
This release contains a bug fix for all platforms.
Release date: August 9, 2019
Download Binary: Windows 32-bit | Windows 64-bit | Mac | Linux 64-bit
View Source Code: Mattermost Desktop on GitHub
Bug Fixes
All Platforms
Fixed an issue where the server URL entry prior to v4.2.2 could include malformed URLs that failed in v4.2.2 and later due to stricter validation. https://github.com/mattermost/desktop/pull/1015
Release v4.2.2
This release contains a bug fix for all platforms.
Release date: August 7, 2019
Bug Fixes
All Platforms
Mattermost v4.2.2 contains high level security fixes. Upgrading is recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Release v4.2.1
This release contains a bug fix for all platforms.
Release date: March 20, 2019
Download Binary: Windows 32-bit | Windows 64-bit | Mac | Linux 64-bit
View Source Code: Mattermost Desktop on GitHub
Bug Fixes
All Platforms
Fixed an issue where some links opened in a smaller window in the Mattermost app. This issue only affected installations with a Site URL configured to use a subpath.
Release v4.2.0
Release date: November 27, 2018
Download Binary: Windows 32-bit | Windows 64-bit | Mac | Linux 64-bit
View Source Code: Mattermost Desktop on GitHub
Note: Mattermost v4.2.0 contains a high level security fix. Upgrading is highly recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.
Improvements
All Platforms
Added English (UK), Portuguese (BR), Spanish (ES) and Spanish (MX) to the spell checker.
Added Ctrl/Cmd+F shortcut to work as browser-like search.
Preserved case of first letter in spellcheck.
Added support for session expiry notification.
Windows
Set “app start on login” preference as enabled by default and synchronized its state with config.json.
Linux
[tar.gz] Added support for using SVG icons for Linux application menus in place of PNG icons.
Updated categories in order to be listed under the appropriate submenu of the application starter.
Set “app start on login” preference as enabled by default and synchronized its state with config.json.
Added AppImage packages as an unofficial build.
Architectural Changes
Major version upgrade of Electron to v2.0.12. Electron is the underlying technology used to build the Desktop apps.
Artifact names are now configured via electron-builder.json.
Release v4.1.2
This release contains a bug fix for all platforms.
Release date: May 25, 2018
Download Binary: Windows 32-bit | Windows 64-bit | Mac | Linux 64-bit
View Source Code: Mattermost Desktop on GitHub
Release v4.1.1
This release contains multiple bug fixes for Mac due to an incorrect build for v4.1.0. Windows and Linux apps are not affected.
Release date: May 17, 2018
Download Binary: Windows 32-bit | Windows 64-bit | Mac | Linux 64-bit
View Source Code: Mattermost Desktop on GitHub
Bug Fixes
Each of the issues listed below are already fixed for Windows and Linux v4.1.0.
Mac
Fixed an issue where right-clicking an image, then choosing “Save Image”, did nothing.
Fixed an issue that prevented typing in the form fields on the add server dialog when launched from the server tab bar.
Fixed an issue that could cause an error message on the add new server dialog to be misleading.
Fixed an issue where timestamps in message view showed no URL on hover.
Fixed an issue where quitting and reopening the app required the user to log back in to Mattermost.
Fixed an issue where adding a new server sometimes caused a blank page.
Fixed deep linking via
mattermost://
protocol spawning a new copy of the Desktop App on the taskbar.
Release v4.1.0
Release date: May 16, 2018
Improvements
All Platforms
Improved stability and performance
Reduced memory usage by periodically clearing cache.
Fixed app crashing when a server tab was drag-and-dropped to the message view.
Added an option to disable GPU hardware acceleration in App Settings to improve stability in some systems.
Fixed Windows crash issues during installation.
Fixed Mac and Linux crashing after toggling “Show Mattermost icon in menu bar” app setting.
Updated design for loading animation icon.
Improved appearance of server tabs.
Enabled Certificate Transparency verification in HTTPS.
Architectural Changes
Major version upgrade of Electron from v1.7.13 to v1.8.4. Electron is the underlying technology used to build the Desktop apps.
Mac download files now use Zip packages rather than tar.gz files.
ES6
import
andexport
now replace therequire
andmodul.export
modules for better development.Storybook added to more easily develop React componets without executing the desktop app.
Bug Fixes
All Platforms
Fixed an issue where an incorrect spellchecker language was used for non
en-US
locales on initial installation.Fixed an issue where error page appeared when U2F device was used for multi-factor authentication through single sign-on.
Fixed an issue where right-clicking an image, then choosing “Save Image”, did nothing.
Fixed an issue that prevented typing in the form fields on the add server dialog when launched from the server tab bar.
Fixed an issue that could cause an error message on the add new server dialog to be misleading.
Known Issues
All Platforms
Clicking on a video preview opens another Mattermost window in addition to downloading the file.
Insecure connection produces hundreds of log messages.
Windows
App window doesn’t save “floating” app position.
[Windows 7] Sometimes app tries to render a page inside the app instead of in a new browser tab when clicking links].
[Windows 10] Incorrect task name in Windows 10 startup list.
Mattermost UI sometimes bleeds over a file explorer.
When auto-starting the desktop app, the application window is included in Windows tab list.
Release v4.0.1
Release date: March 28, 2018
This release contains multiple security updates for Windows, Mac and Linux, and it is highly recommended that users upgrade to this version.
Release 4.0.0
Release date: January 29, 2018
This release contains multiple security updates for Windows, Mac and Linux, and it is highly recommended that users upgrade to this version.
Improvements
All Platforms
Added a dialog to allow the user to reopen the desktop app if it quits unexpectedly.
Mattermost animation icon is now displayed when loading a page, instead of a blank screen.
Added a dialog to request permissions to show desktop notifications or to use microphone and video for video calls from untrusted origins.
The “Saved” indicator now appears for both Server Management and App Options on the Settings page.
Close button on the Settings page now has a hover effect.
Added new admin configuration settings for:
Disabling server management where the user cannot add or edit the server URL.
Setting one or more pre-configured server URLs for the end user.
Customizing the link in Help > Learn More...
Architectural Changes
Major version upgrade of Electron from v1.6.11 to v1.7.11. Electron is the underlying technology used to build the Desktop apps.
The app now uses CSS to style the user interface. Styles are also divided into React’s inline style and CSS.
Yarn is now used to manage dependencies across Windows, Mac and Linux builds.
Build is now run automatically before packaging the apps with npm run package.
Removed hardcoded product name references.
Added an rm command to npm, which removes all dynamically generated files to make it easy to reset the app between builds and branches.
Bug Fixes
All Platforms
Fixed the close button of the Settings page not working on first installation.
Fixed the app publisher referring to Yuya Ochiai instead of Mattermost, Inc.
Fixed font size not always persisting across app restarts.
Fixed an automatic reloading of the app when a DNS or network error page is manually reloaded with CTRL/CMD+R.
Fixed an issue where changing font size caused rendering issues on next restart.
Fixed an issue where after adding a server on the Settings page, focus remained on the “Add new server” link.
Fixed an issue where SAML certificate file couldn’t be uploaded from the file upload dialog.
Windows
Fixed desktop notifications not working when the window was minimized from an inactive state.
Fixed the uninstaller not removing all files correctly.
Known Issues
Windows
App window doesn’t save “floating” app position.
Windows 7: Sometimes the app tries to render the page inside the app instead of in a new browser tab when clicking links.
Windows 10: Incorrect task name in Windows 10 start-up list.
Release 3.7.1
Release date: August 30, 2017
This release contains a security update for Windows, Mac and Linux, and it is highly recommended that users upgrade to this version.
Release 3.7.0
Release date: May 9th, 2017
Improvements
All Platforms
Added an inline spell checker for English, French, German, Spanish, and Dutch.
Removed an obsolete “Display secure content only” option, following an upgrade of the Electron app to Chrome v56.
Reset app window position when restoring it off-screen from a minimized state.
Improved page loading and app view rendering.
Bug Fixes
All Platforms
An extra row is no longer added after switching channels with CTRL/CMD+K shortcut.
Fixed an issue where an unexpected extra app window opened after clicking a public link of an uploaded file.
Fixed JavaScript errors when refreshing the page.
Fixed vertical alignment of the Add Server “+” button in the server tab bar.
Windows
Focus is now set to the next top-level window after closing the main app window.
Fixed an issue where the app remained in the “classic” ALT+TAB window switcher after closing the main app window.
Known Issues
Mac
After uploading a file with a keyboard shortcut, focus isn’t set back to the message box
The application crashes when a file upload dialog is canceled without closing Quick Look.
Linux (Beta)
[Ubuntu - 64 bit] Right clicking taskbar icon and choosing **Quit** only minimizes the app
[Ubuntu - 64 bit] Direct message notification comes as a streak of line instead of a pop up
Release 3.6.0
Release date: February 28, 2017
Upgrading to Mattermost server 3.6 or later is recommended, as new features for the desktop app have been added following the release of the team sidebar.
Improvements
Added support for unread indicators following the release of team sidebar in Mattermost server 3.6
Removed a confusing CTRL/CMD+S shortcut for searching within a Mattermost team
Added support for SAML OneLogin and Google authentication for Enterprise users
Switching to a server from the system tray icon, from “Window” menu bar item, or through CTRL/CMD+{n} shortcut now works while viewing the Settings page
Streamlined desktop server management:
“Team Management” changed to “Server Management” following the release of team sidebar in Mattermost server 3.6
Added a “+” icon to the desktop server tab bar to more easily sign into a new Mattermost server
Added an option to sign in to another Mattermost server from File > Sign in to Another Server
Clicking “Add new server” on the Settings page opens a dialog instead of a new row
Clicking “Remove” next to a server now requires a confirmation to prevent a user from removing the server by accident
Clicking “Edit” next to a server on the Settings page opens a dialog
Clicking on a server on the Settings page opens the corresponding server tab
Simplified desktop app options:
App options now auto-save when changed
Added supporting help text for each option
Removed “Leave app running in menu bar when application window is closed” setting for Mac, which is not applicable for that platform
Removed “Toggle window visibility when clicking on the tray icon” setting for Windows, given the behavior is inconsistent with typical Windows app behavior
Removed “Hide menu bar” setting to avoid users not being able to use the menu bar and the Settings page
Bug Fixes
All Platforms
Mattermost window no longer opens on a display screen that has been disconnected
Mention badges no longer persist after logging out of a Mattermost server
After right-clicking an image or a link, the “Copy Link” option no longer moves around when clicking different places afterwards
Fixed an issue where minimum window size is not set
Changed target resolution size to 1000x700 to prevent unintended issues on the user interface
Fixed an issue where the application menu is not updated when the config file is saved in the Settings page
Fixed login issues with local development environment
Removed a white screen which was momentarily displayed on startup
Known Issues
Linux (Beta)
[Ubuntu - 64 bit] Right clicking taskbar icon and choosing **Quit** only minimizes the app
[Ubuntu - 64 bit] Direct message notification comes as a streak of line instead of a pop up
Release v3.5.0
Release date: December 14, 2016
Improvements
All Platforms
URL address is shown when hovering over links with a mouse
Added CTRL+SHIFT+MINUS as a shortcut for decreasing font size (zooming out)
Reduce upgrade issues by properly clearing cache when updating the desktop app to a new version (the application cache will be purged whenever the desktop app version changes)
When launching the app from the command line interface, unnecessary warning messages are no longer sent if connecting to a trusted https connection without a
certificate.json
file
Bug Fixes
All Platforms
YouTube previews now work, even if mixed content is allowed
Fixed an incorrect cursor mode for “Edit” and “Remove” buttons on the Settings page
Fixed an issue where “Zoom in/out” settings did not properly work
When disconnected from Mattermost, the “Cannot connect to Mattermost” page is now properly aligned at the top of the window
Known Issues
Linux (Beta)
[Ubuntu - 64 bit] Right clicking taskbar icon and choosing Quit only minimizes the app
[Ubuntu - 64 bit] Direct message notification pop ups do not properly render
Release v3.4.1
Release date: September 30, 2016
This release contains a security update and it is highly recommended that users upgrade to this version.
Version number updated to 3.4 to make numbering consistent with Mattermost server and mobile app releases. This change will not imply monthly releases.
v3.4.1, released 2016-09-30
(Mac) Fixed an issue where the app window pops up second to foreground when a new message is received
v3.4.0, released 2016-09-22
Original v3.4 release
Improvements
All Platforms
Current team and channel name shown in window title bar
Team tab is bolded for unread messages and has a red dot with a count of unread mentions
Added new shortcuts:
CTRL+S; CMD+S on Mac: sets focus on the Mattermost search box
ALT+Left Arrow; CMD+[ on Mac: go to previous page in history
ALT+Right Arrow; CMD+] on Mac: go to next page in history
Upgraded the Settings page user interface
The app now tries to reconnect periodically if a page fails to load
Added validation for name and URL when adding a new team on the Settings page
Windows
Added access to the settings menu from the system tray icon
Only one instance of the desktop application will now load at a time
Added an option to configure whether a red badge is shown on taskbar icon for unread messages
Linux (Beta)
Added an option to flash taskbar icon when a new message is received
Added a badge to count mentions on the taskbar icon (for Unity)
Added a script,
create_desktop_file.sh
to createMattermost.desktop
desktop entry to help integrate the application into a desktop environment more easilyAdded access to the settings menu from the system tray icon
Only one instance of the desktop application will now load at a time
Bug Fixes
All Platforms
Cut, copy and paste are shown in the user interface only when the commands are available
Copying link addresses now work properly
Saving images by right-clicking the image preview now works
Refreshing the app page no longer takes you to the team selection page, but keeps you on the current channel
Fixed an issue where the maximized state of the app window was lost in some cases
Fixed an issue where shortcuts didn’t work when switching applications or tabs in some cases
Windows
Removed misleading shortcuts from the system tray menu
Removed unclear desktop notifications when the application page fails to load
Fixed the Mattermost icon for desktop notifications in Windows 10
Fixed an issue where application icon at the top left of the window was pixelated
Fixed an issue where the application kept focus after closing the app window
Known Issues
Linux (Beta)
[Ubuntu - 64 bit] Right clicking taskbar icon and choosing Quit only minimizes the app
[Ubuntu - 64 bit] Direct message notification comes as a streak of line instead of a pop up
Release v1.3.0
Release date: 2016-07-18
Download the latest version here.
Improvements
All Platforms
Added auto-reloading when tab fails to load the team.
Added the ability to access all of your teams by right clicking the system tray icon.
Windows
Added an installer for better install experience.
The app now minimizes to the system tray when application window is closed.
Added an option to launch application on login.
Added an option to blink the taskbar icon when a new message has arrived.
Added tooltip text for the system tray icon in order to show count of unread channels/mentions.
Added an option to toggle the app to minimize/restore when clicking on the system tray icon.
Bug Fixes
Known Issues
Linux (Beta)
[Ubuntu - 64 bit] Right clicking taskbar icon and choosing Quit only minimizes the app
[Ubuntu - 64 bit] Direct message notification comes as a streak of line instead of a pop up
Release v1.2.1 (Beta)
Release date: 2016-05-24
This release contains a security update and it is highly recommended that users upgrade to this version.
v1.2.1, released 2016-05-24
Fixed an issue where “Electron” appeared in the title bar on startup.
Added a dialog to confirm use of non-http(s) protocols prior to opening links. For example, clicking on a link to
file://test
will open a dialog to confirm the user intended to open a file.(Windows and OS X) Added a right-click menu option for tray icon to open the Desktop application.
v1.2.0, released 2016-05-13
Original v1.2 release
Improvements
Bug Fixes
Known issues
The shortcuts can’t switch teams twice in a row.
The team pages are not correctly rendered until the window is resized when the zoom level is changed.
Release v1.1.1 (Beta)
Release date: 2016-04-13
This release contains a security update and it is highly recommended that users upgrade to this version.
v1.1.1, released 2016-04-13
If the specified team URL on the Settings page contains an additional space, the app now properly redirects to the team page
ALT+SHIFT now opens the menu on Cinnamon desktop environment.
v1.1.0, released 2016-03-30
Original v1.1 release
The electron-mattermost
project is now the official desktop application for the Mattermost open source project.
Changes
All platforms
Rename project from
electron-mattermost
todesktop
Rename the executable file from
electron-mattermost
toMattermost
The configuration directory is also different from previous versions.
Should execute following command to take over
config.json
.Windows:
mkdir %APPDATA%\Mattermost and copy %APPDATA%\electron-mattermost\config.json %APPDATA%\Mattermost\config.json
OS X:
ditto ~/Library/Application\ Support/electron-mattermost/config.json ~/Library/Application\ Support/Mattermost/config.json
Linux:
mkdir -p ~/.config/Mattermost && cp ~/.config/electron-mattermost/config.json ~/.config/Mattermost/config.json
Improvements
All platforms
Refined the application icon.
Show error messages when the application fails to load the Mattermost server.
Show confirmation dialog to continue connection when there is a certificate error.
Added validation to check whether Name or URL are blank when adding or editing a team on the Settings page.
Added simple basic HTTP authentication (requires a command line).
Known issues
All platforms
Basic authentication is not working and requires a command line.
Some keyboard shortcuts are missing (e.g. CTRL+W, CMD+PLUS).
Windows
Application does not appear properly in Windows volume mixer.
List of releases before the project was promoted as the official desktop application for Mattermost.
Release v1.0.7 (Unofficial) - 2016-02-20
Release v1.0.6 (Unofficial) - 2016-02-16
Release v1.0.5 (Unofficial) - 2016-02-13
Release v1.0.4 (Unofficial) - 2016-02-12
Release v1.0.3 (Unofficial) - 2016-02-03
Release v1.0.2 (Unofficial) - 2016-01-16
Release v1.0.1 (Unofficial) - 2016-01-06
Release v1.0.0 (Unofficial) - 2015-12-27
Release v0.5.1 (Unofficial) - 2015-12-12
Release v0.5.0 (Unofficial) - 2015-12-06
Release v0.4.0 (Unofficial) - 2015-11-03
Release v0.3.0 (Unofficial) - 2015-10-24