How To Re-Program Your Button

Customize Your Button With Any Keyboard Shortcuts!  Here are the steps to re-program your button so you can customize which keyboard shortcuts to use:

Step 1 - Installation

Download and install the Arduino IDE: https://www.arduino.cc/en/software

Step 2 - Connect your button

Connect your Zoom Button to your computer with the provided micro-USB cable.

Step 3 - Select Board

Open the Arduino IDE and select the "Arduino Micro" board.  From your Arduino IDE top menu, go to:

Tools > Board > Arduino Micro

Step 4 - Select Port

In order to communicate with your button, you need to let the Arduino IDE know which serial port your button is connected to. From your Arduino IDE top menu, go to:

Tools > Port > "dev/cu.usbmodemHIDPC1 (Arduino Micro)"

This is an example for Mac OSX, but any other operating system should list something similar (look for the Arduino Micro port).

Step 5 - Clone Repo

All of the firmware for the Zoom Button is open sourced and can be found here: https://github.com/alan707/zoom_button.  To clone the repo, open your terminal and run the following commands in this order:

cd ~
git clone https://github.com/alan707/zoom_button.git

Step 6 - Open the Zoom Button source code

Now that you've cloned the Zoom Button repo, you can open any file from that Github repository. For example, let's pick the zoom_button.ino source code:

From your Arduino IDE top menu, go to:

File > Open > zoom_button > firmware > mega32u4 > zoom_button > zoom_button.ino

Step 7 - Flash the program

Before making any modifications, let's confirm that we can flash the default zoom_button.ino program to your button. This will only work because we previously selected the right Board and Port under Tools. Alright, let's try to flash it!

From your Arduino IDE top menu, go to:

Sketch > Upload

Step 8 - Success!

Your button is now flashed.  Check for the "Done uploading." message in your Arduino IDE console

Now Try Your Own Keyboard Shortcuts!

Explore the Zoom Button Github repo and get familiar with other examples so you know what part of the code is safe to modify. Once you've made modifications to your code, save it as a new *.ino file in a new folder with the same name as your new filename (Arduino requires that the folder name matches the filename). e.g. mac_sleep folder has a mac_sleep.ino file inside of it and so on. Here is a useful guide of the available keys such as CTRL, CMD, ALT, etc: https://www.arduino.cc/reference/en/language/functions/usb/keyboard/keyboardmodifiers/