A Stream Deck plugin providing convenient Zoom meeting controls directly from your Elgato Stream Deck.

• Zoom Mute Toggle: Toggle your Zoom audio mute status with a single button press
• Zoom Video Toggle: Toggle your Zoom camera/video with a single button press
• Zoom Screen Share: Start or stop screen sharing in Zoom meetings with a single button press
• Zoom Focus: Bring the Zoom application to the foreground instantly
• Zoom Leave Meeting: Leave the current Zoom meeting with a single button press
• Works even when Zoom is not the active application

• macOS (currently not supported on Windows)
• Stream Deck Software (minimum version 6.4)
• Zoom desktop client (with default keyboard shortcuts)
• Node.js v20+ (for development)

1. Clone this repository
2. Run npm install to install dependencies
3. Run ./script/build to build and install the plugin

For information on packaging and releasing this plugin to the Stream Deck Store, see the Release Documentation.

For developers wanting to extend or modify this plugin:

• Run ./script/run for development with live reloading
• Run ./script/convert-icons to convert SVG icons to PNG format
• Check .github/copilot-instructions.md for detailed developer guidance

The plugin uses SVG files as the source for all icons, which are then converted to PNG files during the build process. To modify icons:

1. Edit the SVG files in com.max-beizer.zerm.sdPlugin/imgs/actions/[action-name]/
2. Run ./script/build which automatically converts SVGs to PNGs before building using ImageMagick's modern magick command

The plugin uses AppleScript to:

1. Remember which application is currently active
2. Briefly activate Zoom
3. Send keyboard shortcuts to control Zoom
4. Return to the original application

This provides a seamless experience, allowing you to control Zoom without switching context.

MIT