Repolode
Submit
IsmaelMartinez

IsmaelMartinez/teams-for-linux

Unofficial Microsoft Teams desktop client for Linux, wrapping the Teams web app with native notifications, tray integration and multi-profile support.

Open-source alternative to:Microsoft Teams

View on GitHubWebsite
Stars
5,164
Forks
406
Open issues
40
Last commit
20 hours ago

What is it?

Teams for Linux is an unofficial desktop client for Microsoft Teams that runs on Linux. It wraps the Teams web application in a native Electron app, so Linux users who cannot use the official Windows or macOS client get a dedicated window instead of a browser tab.

The app adds Linux-oriented integration on top of the web version, including system notifications, system tray support with badges that vary by desktop environment, custom video call backgrounds, screen sharing, and separate profiles for running work and personal accounts side by side. Some behaviour is limited by what the Teams web app itself allows.

Packages are available as AppImage, deb, rpm, snap and Flatpak, and the project lists distribution packages for Arch (AUR) and others. Because Electron's context isolation and sandbox are disabled to access Teams DOM features, the project recommends Flatpak or Snap confinement, or Firejail, for additional isolation.

Key features

  • 01Native system notifications for Teams messages and calls
  • 02System tray integration with badge support varying by desktop environment
  • 03Custom video call backgrounds and themes
  • 04Screen sharing support on Linux
  • 05Multiple account profiles for work and personal use

Use cases

  • Using Microsoft Teams daily on a Linux workstation without a browser tab
  • Keeping work and personal Teams accounts running in separate windows
  • Installing Teams via AppImage, deb, rpm, snap or Flatpak on mainstream distributions

Quick start

  1. 1

    Install using a package repository or distribution package listed in the README

  2. 2

    Launch the app

    teams-for-linux
  3. 3

    Optionally create a configuration file if needed

    ~/.config/teams-for-linux/config.json

Things to know

  • Electron's contextIsolation and sandbox features are disabled, so system-level sandboxing such as Flatpak or Snap is recommended.
  • Some features such as tray badges depend on the desktop environment and are limited by the Teams web app.
  • Licensed under GPL-3.0, a copyleft license.

Topics

#electron#linux#microsoft-teams#desktop-app#video-conferencing#chat#microsoft#teams

FAQ

What is teams-for-linux?
Unofficial Microsoft Teams desktop client for Linux, wrapping the Teams web app with native notifications, tray integration and multi-profile support. Teams for Linux is an unofficial desktop client for Microsoft Teams that runs on Linux. It wraps the Teams web application in a native Electron app, so Linux users who cannot use the official Windows or macOS client get a dedicated window instead of a browser tab.
Is teams-for-linux free to use? What license does it have?
teams-for-linux is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is teams-for-linux still maintained?
Actively maintained. The last commit to teams-for-linux was on Oct 19, 2026.
What can I use teams-for-linux for?
Using Microsoft Teams daily on a Linux workstation without a browser tab Keeping work and personal Teams accounts running in separate windows Installing Teams via AppImage, deb, rpm, snap or Flatpak on mainstream distributions
How do I install teams-for-linux?
Install using a package repository or distribution package listed in the README Launch the app: teams-for-linux Optionally create a configuration file if needed: ~/.config/teams-for-linux/config.json
Where can I get teams-for-linux?
The source code and installation instructions are on GitHub: https://github.com/IsmaelMartinez/teams-for-linux

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects