Teams for Linux Documentation

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 ✅ Custom backgrounds & themes ✅ Screen sharing support ✅ Multiple account profiles ✅ Certificate management ✅ Proxy server support ✅ Microsoft Intune SSO integration ✅ Secure token storage ✅ Protocol handler support ✅ MQTT integration for home automation ✅ Advanced logging & debugging

Project Status

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

Getting Started

Installation

• Installation Guide - Package repositories, distribution packages, and manual installation
• Configuration Guide - Complete configuration options and settings
• Multiple Instances - Running separate profiles (work/personal)
• Intune SSO Integration - Microsoft Intune Single Sign-On for enterprise environments

Features

• Screen Sharing Guide - Complete screen sharing implementation and usage
• Custom Backgrounds - Setting up custom video call backgrounds
• Certificate Management - Custom CA certificate handling for corporate environments
• MQTT Integration - Home automation and status publishing via MQTT

Developer Documentation

• Development Guide - Architecture patterns, security guidelines, and development practices
• Contributing Guide - Development setup, code standards, and contribution guidelines
• Architecture Decision Records - Significant technical decisions and their rationale
• Research Documentation - Strategic analysis and research documents

Architecture Overview

For detailed architecture documentation, see the Development Guide.

Quick Start

1. Basic Usage: Launch with teams-for-linux
2. Configuration: Create ~/.config/teams-for-linux/config.json with your settings
3. Troubleshooting: Check the Troubleshooting Guide for common issues
4. Multiple Profiles: Use --user-data-dir and --class flags for separate instances

Support & Community

• Troubleshooting Guide - Common issues and solutions
• Installation Guide - Setup and installation help
• Contributing Guide - How to contribute to the project
• 💬 Chat: Matrix room
• 🐛 Issues: Report bugs