They're asked first
The first time your OBS is in a call with a friend, Grumble asks them. Until they say yes, your OBS gets nothing of theirs, whether camera, screen or voice.
Grumble for OBS
Your call, live on your stream.
Put friends from your Grumble call into OBS, each as a source of their own, with their camera and voice or their screen and its sound. It's free and open source.
Windows 10 or 11 · OBS 32 or newer · on macOS and Linux, use a browser source
Every friend, a source of their own.
Add a Grumble call member source, pick someone from your call, and choose their camera and voice, or their screen and its sound. Move them, crop them and set their volume like any other source.
There's no capturing the Grumble window and no routing audio around. Each source carries just that person, with their own slider in OBS's audio mixer.
Set it up
Three steps, then you're live.
-
Install the plugin
Run the installer from this page, then restart OBS. With the Grumble app for Windows, you can skip the download. In a call, open ⋯ → Stream to OBS and click Install in OBS.
-
Copy your plugin key
In a Grumble call, open ⋯ → Stream to OBS and click Copy plugin key. In OBS, add a Grumble call member source and paste it in once.
-
Pick who to show
Choose a Person, from your call first and then your friends, and whether to Show their camera and voice or their screen and its sound. Add a source for each person you want.
Nobody's on stream by surprise
Your friends say yes first.
Going live with someone is their choice too. Grumble asks them, shows everyone who's going out, and keeps the call as private as it always is.
And can stop it any time
Their yes is remembered for calls with you. To take it back, they open your menu in a call and choose Stop showing me on their stream.
Everyone can see it
Whoever's going into a stream has the OBS mark on their tile, for everyone in the call, so nobody is on a stream without knowing.
Still end-to-end encrypted
OBS joins your call as a watch-only guest and decrypts it on your PC, the same way the Grumble app does. Our servers still can't see or hear a thing.
Your key stays yours
Your plugin key works only while you're in a call, and whoever has it can watch that call as you, so keep it in OBS. If it gets out, Turn off every link in Stream to OBS.
Open source
The plugin is free software under the GNU GPL, version 2 or later. Its source code is right here, so you can read exactly what it does, or build it yourself.
Without the plugin
Use a browser source.
On macOS and Linux, or if you'd rather not install anything, every camera and screen in a call has a link OBS can show. Friends still say yes first, and it stays encrypted the same way.
-
Copy its link
In a Grumble call, point at someone's camera or screen and click the OBS button in its corner.
-
Add a browser source
In OBS, add a Browser source, paste the link as its URL, and make it 1920 × 1080.
-
Bring the sound
Tick Control audio via OBS, so their voice or their screen's sound gets a slider in the audio mixer.
The download
- Installer
- grumble-obs-setup.exe · 118 KB · version 1.0.0
- Needs
- Windows 10 or 11 (64-bit) and OBS Studio 32 or newer
- SHA-256
508281f3af701c01e539598774115088067c22c3442fbabe0f55b15975f2c398- Source code
- grumble-obs-windows-x64.zip, with the plugin, its source code and licence, and a script to install it by hand
- Licence
- GNU General Public License, version 2 or (at your option) any later version
Good to know
- Windows may stop it the first time, because it's new. Choose More info, then Run anyway. To check you have exactly the file we published, run
certutil -hashfile grumble-obs-setup.exe SHA256and compare. - Close OBS before installing. OBS loads its plugins when it starts, so the installer asks you to close it first.
- No administrator rights needed. It goes in OBS's plugin folder for everyone on the PC, and the Grumble app can keep it up to date from there.
- To remove it, find Grumble for OBS in Windows Settings under Apps → Installed apps.
- macOS and Linux don't have the plugin yet, so use a browser source there. On Linux you can also build it from its source.
Grumble for OBS is made by Aternix. It isn't made or endorsed by the OBS Project.