Skip to content

teams

This directory provides integration and voice command support for Microsoft Teams across multiple operating systems, including Windows, Linux, and macOS. It maps verbal commands to the specific keyboard shortcuts utilized by Microsoft Teams for navigating the interface, sending messages, and managing active video or audio calls.

Application Definition and OS Support

To ensure that the appropriate voice commands are only active when Microsoft Teams is focused, the files work together to define application scopes and handle system-specific behaviors.

  • teams.py: Defines the microsoft_teams application identifier for Linux. It matches process names containing either /teams/ or /Teams/.
  • teams_linux.py: Overrides default edit actions (zoom_in, zoom_out, and zoom_reset) to use the Linux-specific control key bindings (ctrl-=, ctrl--, ctrl-0) when Microsoft Teams is active.

Voice Commands

The voice commands are split into two .talon files depending on the underlying operating system. They align with standard Microsoft Teams hotkeys for navigation, messaging, and meetings.

  • teams.talon: Implements shortcuts for Windows and Linux. Since these platforms share highly similar key combinations (typically relying on ctrl and alt), they are bundled together.
  • teams_mac.talon: Implements equivalent shortcuts for macOS. Because macOS uses the super (Command) key and has different system-level key assignments, this file translates the commands to Mac-specific behaviors (such as super-shift-m for muting). It also includes helper macros, like "attach local file", which automates multi-step keyboard interactions.

Command Categories

Both .talon files support key actions divided into several logical groups:

  • General Application Control: Open settings, show shortcuts, access help, and launch global commands.
  • Navigation: Fast switching between the activity feed, chat, teams, calendar, calls, and files, alongside list navigation commands.
  • Messaging: Start a new chat, expand the composition box, attach files, insert new lines, and send messages.
  • Meetings & Calls: Mute/unmute microphone, toggle video, start or decline screen sharing, accept or decline calls, raise/lower hand, and leave meetings.