v2.17.1

2.17.1 (2026-08-20)

Documentation

• add missing commands and CI gotchas to CLAUDE.md (#2882) (c61f0d0)
• adr: add ADR 028 rejecting OTC pre-fill on third-party IdPs (#2881) (d639b42), closes #2869

Maintenance

• snap: migrate base core22 -> core24 via the snapcraft config key (#2758) (e6b8d2e)

v2.17.0

2.17.0 (2026-08-19)

Features

• config: add shortcuts and storage namespaces, deprecate their flat names (#2859) (15e1b7f)
• linux: background portal integration for Flatpak (#2815) (#2826) (fe6d1df)

Bug Fixes

• ci: install elfutils for the flatpak smoke build (#2856) (e2e125c)
• mainAppWindow: clear every profile partition on startup (#2868) (ba6e029)
• menus: clear every profile partition on Quit (Clear Storage) (#2864) (689c140)
• menus: honour clearStorageData when quitting with clear storage (#2861) (210e331)
• network: treat ERR_TIMED_OUT as recoverable so the retry loop survives (#2876) (21a8ed2), closes #2875
• screen-sharing: pass picker source directly to avoid Wayland ID mismatch (#2755) (82d2950)

Performance

• bound timestamp polling, cache tray base icon, parallelise cache scans (#2837) (d623daf)

Code Improvements

• config: aggregate deprecation warnings into one message (#2858) (3992d37)

Documentation

• idle: document driving the idle state file on Wayland (#2873) (d57d352), closes #2851
• update ADR-026 and roadmap for merged portal and perf work (#2857) (a9704bf)

v2.16.0

2.16.0 (2026-08-14)

Features

• multi-account: pin profiles + Ctrl+Alt+1…5 switch shortcuts (ADR-020 Phase 1c.2) (#2787) (08f1db6)

Bug Fixes

• auth: default keepMsalCacheEncryptionCookie to on (#2850) (cc007bf)
• deps: bump nanoid in docs-site lockfile to clear advisory #211 (#2827) (f3f5a97)
• deps: refresh docs-site lockfile to clear http-proxy-middleware advisory (#2823) (4c2785f)
• logging: remove #2587 debug instrumentation that shipped in 2.15.0 (#2814) (0af4c07)
• logging: stop logging notification text and page DOM (#2819) (2157c4f)
• menus: limit hidden-menubar accelerators to profile switching (#2821) (#2824) (2a5be99)
• network: bound the connectivity sweep so a hung probe cannot stall startup (#2816) (ace3bb7)
• notifications: load sender avatars for electron notifications (#2809) (936ffde)
• webauthn: sign the iframe's own origin for relayed ceremonies (#2828) (#2829) (e9db7b2)

Documentation

• adr: ADR-025 config option naming convention (#2836) (dcafe0a)
• adr: ADR-026 performance audit outcomes (#2838) (7689e1d)
• adr: leave the rename mechanism undecided in ADR-025 (#2843) (9c3fb70)

CI/CD

• docs: bound the docs build with timeout-minutes (#2852) (d6d4cb9)
• flatpak: smoke build on release tags, document the beta remote (#2853) (ed9a1da)

Maintenance

• add osv-scanner configuration (#2846) (a314095)
• deps-dev: bump the minor-and-patch group with 2 updates (#2820) (a00ba0a)
• deps: bump brace-expansion from 5.0.8 to 5.0.9 in /docs-site (#2802) (3d443af)
• deps: bump dompurify from 3.4.12 to 3.4.13 in /docs-site (#2805) (690e820)
• deps: bump fast-uri from 3.1.4 to 3.1.5 (#2800) (55708f5)
• deps: bump fast-uri from 3.1.4 to 3.1.5 in /docs-site (#2804) (46a25e9)
• deps: bump js-yaml from 4.3.0 to 4.3.1 (#2808) (be4ee33)
• deps: bump js-yaml from 4.3.0 to 4.3.1 in /docs-site (#2807) (8466a9f)
• deps: bump mermaid from 11.15.0 to 11.16.1 in /docs-site (#2806) (a5446b5)
• deps: bump undici from 7.28.0 to 7.29.0 (#2799) (1cea4dd)
• deps: bump undici from 7.28.0 to 7.29.0 in /docs-site (#2801) (e271012)
• deps: refresh brace-expansion in the lockfile (#2847) (fe70fb9)
• sonar: clear docker and String.raw findings (#2818) (#2825) (b82434b)
• sonar: clear the code-smell tail (#2813) (894dc4e)

Thanks

Big thanks to @app/dependabot, @app/repo-butler-app, @jochimvd, @jpenberthy for contributing to this release.

v2.15.0

2.15.0 (2026-08-07)

Features

• auth: pre-fill Microsoft web sign-in credentials (#2761) (#2798) (c7c0b0a)
• mqtt: meeting-started detection first pass (#2587) (#2757) (a0b9d72)
• webauthn: log timeout, phase timings and page aborts (#2785) (c82cd33)

Bug Fixes

• auth: Keep msal.cache.encryption cookie on restart (#2780) (12ea841)
• certificate: apply customCACertsFingerprints to every TLS verification (#2778) (0248b63)
• paste: restore File.path on pasted files so Teams uploads accept them (#2790) (fcc3191)
• resolve SonarCloud bug and vulnerability findings (#2766) (25009f6)
• sonar: exclude declarative config schema from duplication checks (#2793) (e54c9d4)
• ui: point dialog placeholders at teams.cloud.microsoft (#2797) (a6843d3)

Documentation

• certificate: document NSS trust store for TLS-inspecting proxies (#2776) (b1e7e67)
• research documentation cleanup (#2769) (688695c)

Maintenance

• deps: bump @easyops-cn/docusaurus-search-local (#2784) (58eafc2)
• deps: bump actions/checkout from 7.0.0 to 7.0.1 (#2773) (3c9133c)
• deps: bump actions/setup-node from 6.4.0 to 7.0.0 (#2772) (df25ab1)
• deps: bump actions/stale from 9 to 11 (#2771) (be1eb71)
• deps: bump github/codeql-action from 3 to 4.37.3 (#2774) (c8644f3)
• deps: bump ip-address from 10.2.0 to 10.4.0 (#2788) (457b198)
• deps: bump the minor-and-patch group in /docs-site with 2 updates (#2765) (f748ecd)
• deps: bump the minor-and-patch group with 3 updates (#2783) (2f619d4)
• deps: bump the minor-and-patch group with 6 updates (#2764) (72f2196)

Thanks

Big thanks to @13pass, @app/dependabot, @FriedrichVoelker, @gj241 for contributing to this release.

v2.14.1

2.14.1 (2026-07-27)

Bug Fixes

• ci: bump electron-builder 26.15.3 -> 26.15.7 to fix DOA snap builds (#2756) (cc5bce1)
• idle: stop hard-exiting on SIGINT/SIGTERM so shutdown flushes storage (#2743) (ab7f46c)

v2.14.0

2.14.0 (2026-07-25)

Features

• clientCertificate: add Linux smartcard PIN dialog and secure prompt (#2659) (509ffbd)
• multi-account: bottom-left profile switcher pill (ADR-020 Phase 1c.2) (#2661) (1cd8f9b)

Bug Fixes

• frameless: update no-drag selectors for Teams top-bar restructure (#2704) (b00b633)
• theme: revert followSystemTheme default to false (#2732) (ea4999e)

Documentation

• add privacy and data protection statement (#2742) (189a26d), closes #2741
• roadmap: record smartcard PIN dialog under awaiting user feedback (#2739) (8fc2223)

CI/CD

• release-please: flag draft releases in the created-release comment (#2700) (d0bd972)

Maintenance

• deps-dev: bump electron from 42.5.1 to 42.7.0 (#2740) (9f4ce43)
• deps-dev: bump the minor-and-patch group with 2 updates (#2709) (57f7f21)
• deps-dev: bump typescript from 6.0.3 to 7.0.2 in /docs-site (#2727) (b0a9fc5)
• deps: bump body-parser from 1.20.5 to 1.20.6 in /docs-site (#2735) (3a23323)
• deps: bump brace-expansion from 5.0.6 to 5.0.7 in /docs-site (#2733) (6ecc9f0)
• deps: bump fast-uri and svgo in root and docs-site lockfiles (#2748) (d32b97e)
• deps: bump js-yaml from 3.14.2 to 3.15.0 in /docs-site (#2725) (160569d)
• deps: bump shell-quote from 1.8.4 to 1.10.0 in /docs-site (#2736) (cd7babe)
• deps: bump the minor-and-patch group across 1 directory with 7 updates (#2726) (96e7c10)
• deps: bump the minor-and-patch group with 2 updates (#2716) (f9f2407)
• deps: bump the minor-and-patch group with 2 updates (#2723) (85fcb9c)
• deps: bump webpack-dev-server from 5.2.5 to 5.2.6 in /docs-site (#2734) (f48f49a)
• deps: bump websocket-driver from 0.7.4 to 0.7.5 in /docs-site (#2729) (9ab02f3)
• remove redundant code comments that restate the code (#2728) (58b3098)

Thanks

Big thanks to @app/dependabot, @jayenashar, @jpenberthy for contributing to this release.

v2.13.0

2.13.0 (2026-06-25)

Features

• macos: Dock presence overlay and Apple Silicon performance switches (#2653) (9b8b8ab)
• media: add media.microphone.ignoreSystemMute to decouple Teams mute from OS mic mute (#2695) (e4e3fad)
• notifications: add electron.clickAction config for window restore (#2660) (6a41a09)

Bug Fixes

• auth: forward pre-login-noise auth signals to reauth recovery (#2688) (b62c6d7)
• ci: pin electron-builder to 26.8.1 to restore Windows exe build (#2697) (048b2af)
• drag-drop: restore File.path on dropped files for Teams uploads (#2679) (2d6c99c)
• snap: pin electron-builder to 26.14.0 to restore snap launch (#2686) (b87de0b)

Documentation

• troubleshooting: add Ubuntu Unity system-tray workaround (#2680) (#2693) (bceb5ae)

CI/CD

• snap: pin snapcraft to 8.x in release workflow (#2696) (f8b577d)

Maintenance

• deps-dev: bump electron in the minor-and-patch group (#2685) (2ffeb67)
• deps-dev: bump the minor-and-patch group with 3 updates (#2690) (0f37503)
• deps: bump actions/checkout from 4 to 7 (#2689) (1c3d5e9)

Thanks

Big thanks to @app/dependabot, @jayenashar, @kedzierp for contributing to this release.

v2.12.0

2.12.0 (2026-06-19)

-- SNAP build failed so this will never make it out of a pre-release and it has been replaced by 2.13.0 --

Features

• config: generate config docs + schema from a single source (#2597 Phase 1) (#2604) (f56d1c6)
• docs: interactive config explorer (#2597 Phase 2) (#2606) (a68875a)
• download: save options, policy-block notification, device-switch guard (#2652) (9ebd4ba)
• mqtt: add configurable media topic names and mute/unmute commands (#2608) (777d5f4)
• window: add minimizeOnClose option (#2623) (70efed0)

Bug Fixes

• auth: don't divert main-frame navigations through about:blank handler (#2605) (0853c9d), closes #2591
• auth: gate in-app reauth recovery behind reauthRecovery.enabled (#2633) (55b185e)
• auth: gate worker UPR recovery behind reauthRecovery opt-in (#2629) (9fd1873)
• auth: intercept login popups to trigger in-app recovery (#2622) (598f9a6)
• ci: extract Electron binary with system unzip (e2e) (#2594) (a431a2d)
• ci: use honest release-please PR header (#2648) (92b6cad)
• deps: bump docs-site deps to patched versions (Dependabot) (#2674) (89aa8c1)
• navigation: keep back/forward working after Teams top-bar restructure (#2672) (189cc9f)
• net: add timeout to connectivity probes to prevent hang after resume (#2635) (944770c)
• theme: stop setting followOsTheme to prevent GraphQL rejection (#2673) (19afd0c)
• tray: clear badge reliably by widening title observation and fixing update race (#2643) (689d93a)

Code Improvements

• multi-account: scope custom-background URL per instance; close out Phase 1 audit docs (#2626) (aa1d07d)

Documentation

• config: config-file validation, generated docs and explorer for #2597 phases 3a/4 (#2642) (576db6b)
• config: phase 0 of config/docs UX initiative (#2597) (#2602) (549d7d7)
• config: record #2597 phase 3b plan, migration as optional companion (#2657) (35c487d)
• install: document the beta apt/rpm channel for pre-releases (#2638) (d53d0f3), closes #2637
• move repository install instructions to the dedicated webpage (#2619) (a3543ae)
• research: documentation, contributing, and config UX (#2598) (648aa2c)
• research: FIDO2 touch-prompt feasibility note (#2631) (#2634) (8b6eacb)
• research: smartcard/NSS PIN dialog feasibility for client-cert auth (#2641) (0cbd31a), closes #2639
• roadmap: note in-review download, macOS, and device-switch work (#2655) (966e500)
• troubleshooting: document Google sign-in user-agent workaround (#2670) (5fabd75)

CI/CD

• snap: pin arm64 snapcraft below 9.0.0 to fix the snap build (#2649) (df1115b)

Maintenance

• deps-dev: bump electron from 41.7.1 to 42.3.0 (#2589) (e64ffd2)
• deps-dev: bump the minor-and-patch group with 2 updates (#2612) (9a6ddf2)
• deps-dev: bump the minor-and-patch group with 4 updates (#2658) (402800a)
• deps: bump actions/setup-node from 6.3.0 to 6.4.0 (#2614) (b278ef5)
• deps: bump actions/upload-artifact from 7.0.0 to 7.0.1 (#2613) (ad341ef)
• deps: bump canonical/setup-lxd action pin (#2615) (cc669d3)
• deps: bump dompurify from 3.4.0 to 3.4.11 in /docs-site (#2664) (aa57fc1)
• deps: bump js-yaml from 4.1.1 to 4.2.0 (#2665) (0a2bb00)
  ...

v2.11.1

2.11.1 (2026-05-29)

Failed to release https://github.com/IsmaelMartinez/teams-for-linux/releases/tag/v2.11.0 so releasing it here with a small version bump on the build images.

CI/CD

• bump checkout to Node 24 and make e2e non-blocking for packaging (#2595) (93b560d)

v2.11.0

2.11.0 (2026-05-27)

NOTE: Superseded by https://github.com/IsmaelMartinez/teams-for-linux/releases/tag/v2.11.1 a build failure meant 2.11.0 didn't get any artifacts.

teams-for-linux 2.11.0 is out with new sticker support and improved Home Assistant integration.

Highlights

• Custom stickers MVP: add your own stickers to the chat panel (#2550). opt-in
• MQTT + Home Assistant: new microphone (#2497), camera (#2582) and incoming-call (#2572) topics, with Home Assistant auto-discovery so entities are created for you
• Wayland screen sharing fixed: getDisplayMedia now routes through the in-app picker (#2534). Please report if you got any issues after the upgrade.
• WM_CLASS / --class fix: custom window class reaches both X11 and Wayland again, fixing the v2.10.0 regression (#2569)
• Diagnostics cleanup: quieter pre-login logs, full PII sanitising of renderer logs, and a crisper macOS dock icon (#2560). We get a lot of noise in the logs from Microsoft side.
• Electron bumped to 41.7.1 (#2583)

Heads-up

followSystemTheme now defaults to true, so the app follows your system light/dark theme out of the box (#2566), and six long-deprecated config keys were removed (#2567), so check your config.json if you used old keys.

Features

• #2476: custom stickers MVP (#2550) (0c31282)
• config: default followSystemTheme to true (#2566) (21e927e)
• mqtt: emit camera-state-changed from renderer for MQTT publishing (#2582) (182d559)
• mqtt: publish incoming-call topic for ring/invite events (#2572) (d7cdd06)
• mqtt: publish microphone state to {topicPrefix}/microphone (#2497) (e8fe6f3)

Bug Fixes

• #2383: also setDesktopName so --class reaches X11 + Wayland (#2569) (a048527)
• #2534: route getDisplayMedia through in-app picker on Wayland (f38f28e), closes #2534
• deps: bump qs and ws in docs-site to resolve security alerts (#2573) (84aefe8)
• logging: down-level pre-login auth-noise from renderer (#2564) (8de3b2d), closes #2560
• logging: run renderer log fields through full PII sanitizer (#2562) (bff6d22), closes #2560
• macos: use 256x256 source for the dock icon (#2563) (8f96c66), closes #2560
• preload: serialize object-shaped unhandled rejections (#2561) (6720768), closes #2560

Code Improvements

• config: remove six deprecated config keys (#2567) (4710fb5)

Documentation

• add vylen linux install/remove instruction (#2559) (2f6c976)
• documentation cleanup and HA discovery docs (#2575) (6eca43c)
• update camera topic and MQTT status to shipped (#2585) (b564e87)

Maintenance

• deps-dev: bump electron from 41.6.1 to 41.7.1 (#2583) (79e9540)
• deps-dev: bump qs from 6.14.2 to 6.15.2 (#2568) (a5c0e89)
• deps-dev: bump tmp from 0.2.5 to 0.2.6 (#2584) (0f3c5ce)
• deps: bump @homebridge/dbus-native in the minor-and-patch group (#2574) (345dc5e)
• remove shipped mqtt-microphone-state-research doc (#2581) (f4c39ed)
• remove simili-bot trial files (#2586) (15613cf)
• update CLAUDE.md for ready → release ready label rename (#2576) (62ff340)

Thanks

Big thanks to @app/dependabot, @CelestifyX for contributing to this release.