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
- Arch Linux or an Arch-based distribution.
- WebKitGTK 4.1, GTK 3 and GStreamer plugins (installed automatically as package dependencies).
- PipeWire (with its PulseAudio compatibility) or PulseAudio, for sound and speaker choice.
- For screen sharing on Wayland:
xdg-desktop-portalwith a backend for your desktop (for examplexdg-desktop-portal-hyprland). - A Zoom account (free or paid). The app joins meetings as you.
2. Install the app
- Download the latest package (
penguin-zoom-*.pkg.tar.zst) from the releases page. - Install it:
sudo pacman -U penguin-zoom-*.pkg.tar.zst - Start Penguin for Zoom from your app launcher, or run
penguin-zoomin a terminal. The window says "Open a Zoom link to join". - Optional: make Penguin open Zoom meeting links. The package registers it for
zoommtg://andzoomus://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.
- Open Settings: press , or choose All settings in the Devices pop-up.
- Under Account, choose Sign in.
- Zoom's own sign-in page opens in the app window. Sign in with your Zoom account. We never see your password.
- Zoom shows what the app asks for: a join token (ZAK) for your account and your basic profile. Choose Allow.
- 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
- Click a Zoom meeting link in your browser, email or chat. When the browser offers to open the Zoom app, the link opens in Penguin.
- Paste a link: copy a Zoom meeting link and press Ctrl V in the Penguin window.
- From a terminal:
penguin-zoom "https://zoom.us/j/123456789?pwd=…". If Penguin is already running, the link goes to the open window.
The passcode in the link is used automatically.
Join screen
- See your camera preview and a microphone level meter.
- Turn the microphone (m) and camera (v) on or off before joining.
- Pick a camera, microphone and speaker with Devices (d), and play a test sound.
- Type the name other participants will see in Join as; it is remembered for next time.
- Choose Join (or press Enter). By joining you agree to Zoom's Terms of Service and Privacy Statement, linked under the button.
In the meeting
- Mute / Unmute your microphone, and Start / Stop video.
- Share your screen or a window. On Wayland your desktop asks which screen or window to share.
- Chat: read and send meeting chat. "Who can see your messages?" under the box shows who will receive them, including when the meeting is being recorded.
- People: the list of participants (a tab next to Chat).
- Gallery / Speaker view: switch between seeing everyone and seeing the active speaker.
- Devices: change camera, microphone or speaker during the meeting.
- Breakout rooms: when the host invites you, a bar offers Join or Later. In a room, Back to main session returns you. (Creating or managing rooms is not available.)
- Recording and app notices: Zoom's recording and consent notices appear as usual. The button at the top left shows which apps can access the meeting's content (Zoom's Active Apps Notifier).
- Leave: the red Leave button, Ctrl Shift L, or closing the window.
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.
| Key | Action |
|---|---|
| m | Mute or unmute the microphone (on the join screen: microphone on or off) |
| v | Camera on or off |
| s | Start or stop screen sharing |
| c | Open or close chat |
| p | Open or close the people list |
| g | Switch gallery and speaker view |
| d | Open or close the devices pop-up |
| , | Open Settings |
| Esc | Close Settings, the devices pop-up or the side panel |
| Ctrl Shift L | Leave the meeting |
| Enter | Join (on the join screen) |
| Ctrl V | Open 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
- Interface style: Standard (a floating control bar with labels) or Keyboard (key hints instead of buttons). All keys work in both.
- Join with microphone muted (on by default) and Join with camera off.
- Hide controls when idle.
- Follow the desktop theme: use your Omarchy theme colours, if you use Omarchy.
- Speaker: chosen in Devices; Penguin sends its sound to that output without changing your system default.
- Account: sign in or sign out of Zoom.
Settings are saved in ~/.config/penguin-zoom/settings.json on your computer.
8. How your data is handled
- Meeting audio, video, screen share and chat go directly between your computer and Zoom. Penguin does not record or store them.
- Your settings and display name are stored only on your computer.
- Your Zoom sign-in tokens are kept only in the running app's memory and are never written to disk.
- To join, the app asks our signing service for a join signature, sending the meeting number and role (and, only when joining as host, your access token for a one-time check). The service stores none of it.
- No analytics, tracking, cookies or ads.
Full details: Privacy policy.
9. Remove the app
Do any or all of these, in this order:
- Sign out: Settings (,) → Account → Sign out. This revokes the app's access token with Zoom and deletes the saved sign-in from your keyring.
- 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.
- Uninstall the program:
sudo pacman -R penguin-zoom - Delete your settings (optional; pacman leaves them in your home folder):
rm -r ~/.config/penguin-zoom - 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
- After you sign out or remove the app from your Zoom account, Penguin can no longer join meetings as you until you sign in and allow it again.
- If you are in a meeting, quitting or uninstalling the app leaves it.
- Nothing in your Zoom account changes: your meetings, recordings, contacts and settings at Zoom are untouched.
Your data after removal
- We hold no data about you, so there is nothing for us to delete. When you remove the app from your Zoom account, Zoom notifies our signing service, which stores nothing and has nothing to delete.
- Tokens disappear when the app quits or you sign out.
- Your settings file stays on your computer until you delete it (step 4).
- Data Zoom holds about your meetings is handled under Zoom's Privacy Statement.
There are no other app-specific removal steps.
10. Troubleshooting
Installing
- pacman reports missing dependencies: update your system first (
sudo pacman -Syu), then install again. - The window opens blank: start
penguin-zoomfrom a terminal and read the messages. Make sure WebKitGTK 4.1 (webkit2gtk-4.1) is installed and up to date. - Clicking a meeting link opens another Zoom app: set Penguin as the handler (step 4 of Install).
Signing in
- Sign-in page does not load: check your internet connection and that nothing else on your computer uses port 53682.
- "Signed in" disappears after a restart: the app keeps your sign-in in the system keyring (GNOME Keyring or another Secret Service provider). Make sure one is installed and unlocked, then sign in again.
- Your organisation blocks the app: some Zoom accounts only allow apps an admin has approved. Ask your Zoom admin.
Joining
- "That doesn't look like a Zoom meeting link": copy the full link (it contains
/j/and a number), or the meeting number. - Joining fails with an error: sign in first (see Add the app), check the passcode, and check that the meeting has started or that the host lets participants join before them.
- Waiting room: the host has to admit you.
Audio, video and sharing
- No camera or microphone: open Devices (d) and pick the right device; check no other app holds the camera.
- No sound: open Devices, pick your speaker and use the test sound. Speaker choice needs PipeWire with PulseAudio compatibility (
pipewire-pulse) or PulseAudio. - Screen sharing does nothing on Wayland: install and run
xdg-desktop-portaland the backend for your desktop. - Some Zoom features are missing: see the FAQ below.
Desktop keys
- Super+Shift+M does nothing: Penguin must be running. Run
penguin-zoom --cmd mute-togglein a terminal to test; it exits with an error if the app is not running. Check the binding is not used by something else.
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.