Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
S

streamdeck-googlemeet

> 编程语言
Open source

A Stream Deck plugin to manage your Google Meet microphone and camera.

393 stars0 likes1 views
WebsiteGitHub

About

A Stream Deck plugin to manage your Google Meet microphone and camera.

Stream Deck Google Meet Plugin

Control Google Meet from your Elgato Stream Deck. Toggle your camera and microphone with a single key press, even when Meet is hidden behind other windows. The Stream Deck buttons light up to show your current on/off status, and stay in sync when you mute yourself directly in Meet. Additional buttons control other parts of the meeting, like raising your hand or leaving the call.

This plugin requires a companion browser extension to function. See Installing below.

Supported platforms: Works on macOS and Windows, with both Chrome and Firefox. Linux is experimentally supported via OpenDeck.

Installing

  1. If you're running on an Apple Silicon Mac (e.g. an M1 chip), you must have Apple's Rosetta 2 installed. If you don't (or if you're not sure), open Terminal and run this command:
softwareupdate --install-rosetta --agree-to-license
  1. From the Releases page, download the com.chrisregado.googlemeet.streamDeckPlugin package and open it. The Stream Deck desktop software will prompt you to install the plugin.

  2. The browser extension is not in the web store, so we'll install it manually:

    For Google Chrome:

    1. From the Releases page, download the chrome-extension zip file and extract it somewhere you can keep it. (If you move the folder after installing, Chrome will uninstall the extension from your browser and you'll have to reinstall it.)
    2. From Chrome's extension settings page (chrome://extensions/), turn on "Developer mode" using the toggle at the top-right corner of the page.
    3. Click the "Load unpacked" button at the top-left corner, and select the folder you extracted the zip to earlier.
    4. You can turn Developer mode back off now if you want.

    For Mozilla Firefox:

    1. From the Releases page, download the Firefox extension .xpi file.
    2. From Firefox's extension settings page (about:addons), click the Settings cogwheel at the top-right of the page, click "Install Add-on From File...", and select the .xpi file that you just downloaded.
    3. Click "Add" on the Firefox popup to allow the extension to install.
  3. If you use an ad blocker (such as uBlock Origin with the EasyPrivacy filter list), you may have to add meet.google.com as a trusted site in your blocker's settings to allow the browser extension to work. (Some filters block websockets to localhost, which this extension needs to communicate with the Stream Deck.)

  4. Add some buttons to your Stream Deck, and start a Google Meet call to try them out!

  5. The first time you go to meet.google.com after installing the browser extension, you'll get a Chrome permission prompt saying "meet.google.com wants to access other apps and services on this device". You must allow permission for the browser extension to work.

It's safe to delete the com.chrisregado.googlemeet.streamDeckPlugin file once it's installed, but the unzipped Chrome extension folder must be kept in the same place as when you installed it.

Updating

To update the Stream Deck plugin, download and open the new plugin package just like when you initially installed it. If you experience any glitches after updating (such as on/off icons not changing on the toggle buttons), please try deleting your Meet buttons and re-adding them to your Stream Deck in the Stream Deck desktop app.

To update the browser extension, uninstall your existing version from your browser's Extension Settings page, and then follow the installation instructions again to install the new version.

Uninstalling

In Chrome, go to your extensions settings page (chrome://extensions/) and click the Remove button for "Stream Deck Google Meet Actions".

In Firefox, go to your extensions settings page (about:addons), click the 3 dots button next to "Stream Deck Google Meet Actions", and click Remove.

In the Stream Deck desktop app, right click on one of the Google Meet actions in the list on the right-hand side of the window, and click the "Uninstall..." button.

Troubleshooting

  • If Chrome won't let you enable the extension because it was not installed from the web store, you may need to allowlist the extension. On Windows, you can do this by editing the registry. Under both HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallWhitelist and HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallAllowlist add a string value, with the name "1" (or a greater number if "1" already exists). The value should be the extension ID, which you can get from chrome://extensions/ with Developer Mode on. If this does not work or you're on another operating system, you may find this post helpful.
  • On Windows, if deleting the com.chrisregado.googlemeet.streamDeckPlugin file after installation results in an "action can't be completed because the file is open" error, quit the Stream Deck desktop software by right clicking its icon in the Windows task tray and clicking Quit Stream Deck, then re-launch the app. Now you should be able to delete the installer.
  • If the Stream Deck mic/camera buttons always indicate that they're disconnected and the chrome://extensions/ page shows Websocket connection errors from the browser extension, make sure you've granted meet.google.com permission for "Apps on device" in Chrome. Click the site information icon in the URL bar to see permissions:

Linux Compatibility via OpenDeck

This Stream Deck plugin is released as a multi-platform build that includes binaries for Linux. There is no official Elgato Stream Deck software for Linux (at the time of writing), but the plugin should work with OpenDeck.

Linux and OpenDeck compatibility should be considered experimental. They are not tested every release.

To install the plugin in OpenDeck:

  1. From the Releases page, download the com.chrisregado.googlemeet.streamDeckPlugin package.
  2. In OpenDeck, go to the Plugins page, click "Install from file", and select the com.chrisregado.googlemeet.streamDeckPlugin package.
  3. You may need to completely quit OpenDeck from your dock / system tray and re-launch it in order for the plugin to load successfully.

How It Works

The Stream Deck plugin launches a localhost-only Websocket server on port 2394, which our browser extension connects to. The plugin and browser extension send messages back and forth over that websocket to notify the Stream Deck when Meet changes its device on/off status, and simulates Meet UI button clicks in your browser when you press a key on your Stream Deck.

The Stream Deck plugin code is in the streamdeck-plugin directory. The browser extension code is in the browser-extension directory. The com.chrisregado.googlemeet.sdPlugin directory contains our Stream Deck assets and it becomes our Stream Deck plugin distributable once we bundle our code with the Elgato streamdeck CLI.

You can use other Websocket software to interact with the browser extension, for example to debug the extension without a Stream Deck.

For example, use wsbroad to launch a Websocket server that the extension will also connect to:

wsbroad 127.0.0.1:2394

wsbroad broadcasts all messages received at the Websocket to all connected clients. Then use websocat to send commands to the extension:

websocat --text --oneshot 'literal:{"event":"toggleMic"}' ws://127.0.0.1:2394

The Websocket interface is considered internal and subject to change across different versions of the plugin.

Developing the Stream Deck Plugin

First Time Setup

The plugin is written in Python. Create a venv to hold your package's dependencies, and install those dependencies:

macOS / Linux:

bash
cd streamdeck-plugin
python3 -m venv venv/
source venv/bin/activate
pip install -r requirements.txt

Windows:

bash
cd streamdeck-plugin
python3 -m venv venv/
venv\Scripts\activate.bat
pip install -r requirements.txt

Remember that virtualenvs are not portable. If you move this folder at all, you'll have to delete the venv and re-create it.

Running Unit Tests

macOS / Linux:

bash
cd streamdeck-plugin
source venv/bin/activate
python -m unittest

Windows:

bash
cd streamdeck-plugin
venv\Scripts\activate.bat
python -m unittest

Bundling

We use pyinstaller to bundle our code, dependencies, and a Python runtime environment into an executable. We put that executable into the com.chrisregado.googlemeet.sdPlugin folder, which in turn gets zipped up by the Elgato streamdeck CLI tool as our final distributable plugin package. That plugin package ends up including any assets we need (e.g. icons), the manifest.json file that defines our plugin for the Stream Deck desktop app, and our executable plugin code. Double-click that plugin package and the Stream Deck software will prompt you to install it.

Our plugin code is written in Python, but the Elgato CLI tool is distributed as a Node module, so you'll need Node.js installed.

To build the plugin:

macOS:

bash
cd streamdeck-plugin
source venv/bin/activate
rm -rf ../com.chrisregado.googlemeet.sdPlugin/dist/macos
pyinstaller --clean --dist "../com.chrisregado.googlemeet.sdPlugin/dist/macos" src/main.py
rm -rf build

Linux:

bash
cd streamdeck-plugin
source venv/bin/activate
rm -rf ../com.chrisregado.googlemeet.sdPlugin/dist/linux
pyinstaller --clean --dist "../com.chrisregado.googlemeet.sdPlugin/dist/linux" src/main.py
rm -rf build

Windows:

bash
cd streamdeck-plugin
venv\Scripts\activate.bat
rmdir /q /s "..\com.chrisregado.googlemeet.sdPlugin\dist\windows"
pyinstaller --clean --dist "..\com.chrisregado.googlemeet.sdPlugin\dist\windows" src\main.py
rmdir /q /s build

Note that the resulting executable is only valid for the OS you built it on. Windows, macOS, and Linux bundles must be created separately from a machine/VM of that OS, and then combined into the com.chrisregado.googlemeet.sdPlugin/dist/ folder with macos, linux, and windows subdirectories for release.

If you're just testing locally (so you only care about one OS), you can place any file in the other OS's executable location (CodePaths from manifest.json) to appease the Elgato packaging tool. Example:

…

Or, if you don't ever plan on publishing your local builds, delete the other OS's CodePath and OS entry in manifest.json so you don't have to worry about multi-OS support.

Finally, use Elgato's streamdeck CLI tool to bundle everything into the Stream Deck plugin distributable that you can install or send to users. From the root of this git repo, run:

bash
npm install -g @elgato/cli

streamdeck pack --output ./build/ --force  com.chrisregado.googlemeet.sdPlugin

In the Stream Deck desktop app, uninstall any old copies of the plugin because the app won't overwrite your installation unless the new build has a newer version number.

You can then double-click the ./build/com.chrisregado.googlemeet.streamDeckPlugin file to install your build of the plugin into the Stream Deck desktop app.

Developing the Browser Extension

Our build tools rely on Node.js, so make sure you have Node.js installed.

Using Google Chrome

Follow the usual "Load unpacked" installation instructions described above, but point Chrome at the browser-extension folder of your git workspace

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Pythonchrome-extensionelgatoelgato-stream-deckgoogle-meet

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言