IsmaelMartinez/teams-for-linux

Teams for Linux

Unofficial Microsoft Teams client for Linux — a native desktop app that wraps the Teams web version with enhanced Linux integration.

✅ System notifications
✅ System tray integration (badge support varies by desktop environment)
✅ Custom backgrounds & themes
✅ Screen sharing support
✅ Multiple account profiles

[!NOTE] This is an independent project, not affiliated with Microsoft. Some features are limited by the Teams web app.

Sponsor

Recall.ai — API for Meeting Recording and Transcription

If you're looking for a meeting recording API, consider checking out Recall.ai, an API that records and transcribes Zoom, Google Meet, Microsoft Teams, in-person meetings, and more.

This sponsorship helps support the ongoing development of teams-for-linux.

Installation

Package Repositories

We have dedicated Debian/DEB and RHEL/Fedora/RPM repositories at https://teamsforlinux.de hosted with :heart: by Nils Büchner. Please follow the installation instructions there.

Distribution Packages

Manual Download

Download from GitHub Releases — available as AppImage, deb, rpm, snap, tar.gz (plus Windows/macOS builds).

[!TIP] For AppImage files, use AppImageLauncher for better desktop integration.

Quick Start

1. Install using your preferred method above
2. Launch with teams-for-linux
3. Configure by creating ~/.config/teams-for-linux/config.json if needed

Documentation

📖 Complete Documentation — Enhanced documentation with search, mobile optimization, and comprehensive guides

Project Activity

Support & Community

• 💬 Chat: Join our Matrix Space
• 🐛 Issues: Report bugs
• 🤝 Contributing: See CONTRIBUTING.md

Security & Sandboxing

Electron's contextIsolation and sandbox features are disabled to enable Teams DOM access functionality. For enhanced security, use system-level sandboxing:

Available options:

• Flatpak: Built-in isolation via Flathub
• Snap packages: Application confinement with auto-updates
• Firejail: Use this script for manual sandboxing
• AppArmor/SELinux: Most Linux distributions include these by default

System-level sandboxing provides better isolation than Electron's built-in features while preserving full functionality.

Advanced Usage

History

Read about the history of this project in the HISTORY.md file.

License

GPL-3.0 — See LICENSE.md

Icons from Icon Duck (CC BY 4.0)