ZoomBow

A Pimoroni Keybow Mini macro pad for controlling Zoom calls. Toggle mute, camera, and system volume with physical keys and color-coded LED feedback.

Original concept from elkentaro.

Features

• Mute/Unmute audio with one key press (Cmd+Shift+A / Ctrl+A)
• Start/Stop video with one key press (Cmd+Shift+V / Ctrl+V)
• Volume control layer via modifier key hold
• LED feedback — green (on), red (off), blue (pressed), purple/yellow (volume mode)
• macOS and Linux support with a one-line toggle

Key Mapping

Key	Default Layer	With Key 3 Held
1	Toggle mute	Volume down
2	Toggle camera	Volume up
3	Layer modifier	Layer modifier

LED Colors

Color	Meaning
Green	Feature is ON
Red	Feature is OFF
Blue (momentary)	Key is being pressed
Purple / Yellow	Volume control layer

Requirements

• Raspberry Pi Zero (any version works; the WH version has pre-soldered headers)
• Pimoroni Keybow Mini
• A microSD card (8 GB or larger)

Setup

1. Assemble the Keybow and flash the microSD card following Pimoroni's Keybow setup guide.

2. Clone this repository onto the root of the microSD card.

3. Edit keys.lua and replace the line:

   require "layouts/default"
   

   with:

   require "zoombow/main"
   

4. Insert the microSD card into the Pi Zero.

5. Connect the Pi to your computer using the data USB port (the one closer to the HDMI connector).

Switching to Linux

By default ZoomBow uses macOS shortcuts. To use Linux shortcuts, edit main.lua and uncomment the Linux line:

-- system = "macOS"
system = "Linux"

License

MIT