Penguin for Zoom

Documentation

How to install Penguin for Zoom, connect it to your Zoom account, use it in meetings, fix common problems, and remove it.

Penguin for Zoom is an independent app, not made, endorsed or supported by Zoom Communications, Inc. Zoom is a trademark of Zoom Communications, Inc. For help with this app, see Support.

1. Prerequisites

2. Install the app

  1. Download the latest package (penguin-zoom-*.pkg.tar.zst) from the releases page.
  2. Install it:
    sudo pacman -U penguin-zoom-*.pkg.tar.zst
  3. Start Penguin for Zoom from your app launcher, or run penguin-zoom in a terminal. The window says "Open a Zoom link to join".
  4. Optional: make Penguin open Zoom meeting links. The package registers it for zoommtg:// and zoomus:// links; if links still open another Zoom app, run:
    xdg-mime default penguin-zoom.desktop x-scheme-handler/zoommtg x-scheme-handler/zoomus

If something goes wrong, see Troubleshooting.

3. Add the app to your Zoom account (sign in)

Zoom requires apps like Penguin to join meetings as a signed-in Zoom user, so sign in once each time you start the app.

  1. Open Settings: press , or choose All settings in the Devices pop-up.
  2. Under Account, choose Sign in.
  3. Zoom's own sign-in page opens in the app window. Sign in with your Zoom account. We never see your password.
  4. Zoom shows what the app asks for: a join token (ZAK) for your account and your basic profile. Choose Allow.
  5. You return to the app, and Settings shows "Signed in as your name".

The app keeps your sign-in only while it runs (nothing is saved to disk), so after you quit and restart it, sign in again. If sign-in fails, see Troubleshooting.

4. Use the app

Open a meeting

The passcode in the link is used automatically.

Join screen

In the meeting

The control bar hides after a few idle seconds and returns when you move the mouse (you can turn this off in Settings).

5. Keyboard keys

These work in the Penguin window when you are not typing in a text box, in both interface styles.

KeyAction
mMute or unmute the microphone (on the join screen: microphone on or off)
vCamera on or off
sStart or stop screen sharing
cOpen or close chat
pOpen or close the people list
gSwitch gallery and speaker view
dOpen or close the devices pop-up
,Open Settings
EscClose Settings, the devices pop-up or the side panel
Ctrl Shift LLeave the meeting
EnterJoin (on the join screen)
Ctrl VOpen a pasted meeting link (on the start screen)

6. Desktop-wide keys (Hyprland)

Mute or leave from anywhere on the desktop, even when Penguin is not focused. The app accepts these commands while it runs:

penguin-zoom --cmd mute-toggle
penguin-zoom --cmd camera-toggle
penguin-zoom --cmd leave
penguin-zoom --cmd raise

Suggested Hyprland bindings (classic hyprland.conf syntax; the package also ships a snippet in /usr/share/penguin-zoom/):

bind = SUPER SHIFT, M, exec, penguin-zoom --cmd mute-toggle
bind = SUPER SHIFT, L, exec, penguin-zoom --cmd leave

Super Shift M mutes or unmutes; Super Shift L leaves the meeting. Other desktops can bind the same commands in their own shortcut settings.

7. Settings

Settings are saved in ~/.config/penguin-zoom/settings.json on your computer.

8. How your data is handled

Full details: Privacy policy.

9. Remove the app

Do any or all of these, in this order:

  1. Sign out: Settings (,) → Account → Sign out. This revokes the app's access token with Zoom and deletes the saved sign-in from your keyring.
  2. Remove the app from your Zoom account: sign in at marketplace.zoom.us/user/installed, find Penguin for Zoom, and choose Remove. This cancels all access the app had to your account, even on other computers.
  3. Uninstall the program:
    sudo pacman -R penguin-zoom
  4. Delete your settings (optional; pacman leaves them in your home folder):
    rm -r ~/.config/penguin-zoom
  5. If you added Hyprland bindings or changed the link handler, remove those lines from your Hyprland config, and set your previous Zoom app as the handler again, for example xdg-mime default Zoom.desktop x-scheme-handler/zoommtg x-scheme-handler/zoomus.

What removal means

Your data after removal

There are no other app-specific removal steps.

10. Troubleshooting

Installing

Signing in

Joining

Audio, video and sharing

Desktop keys

Still stuck? Contact support.

11. FAQ

Is this the official Zoom app?

No. Penguin is an independent app that uses Zoom's Meeting SDK. It is not made, endorsed or supported by Zoom.

Does it cost anything?

No. You need a Zoom account, which can be a free one.

Which Zoom features are not included?

Penguin is deliberately light. It does not include whiteboards, polls, recording controls, virtual backgrounds, creating or managing breakout rooms, or Zoom's other apps. Use Zoom's own apps for those.

Does Penguin record meetings or keep chat?

No. It does not record, store or upload meeting content.

Why do I have to sign in?

Zoom requires apps built on its Meeting SDK to join meetings as a signed-in Zoom user.

Will I get emails from you?

No. We don't collect your email address and send no emails, except replies to messages you send us.

Does it work outside Hyprland?

Yes, on any Linux desktop where WebKitGTK runs. It is tested on Wayland with Hyprland.

12. Contact support

Support hours: Sunday to Thursday, 09:00–18:00 Israel time. We aim to reply within 3 business days. Open an issue on GitHub or email dibs.apps@gmail.com. Details on the support page.