Moment - Documentation

1. Adding the App

Moment consists of two parts: the Zoom App (runs inside your Zoom meeting as a sidebar panel) and the Companion (a lightweight desktop helper that captures screenshots on your computer).

Install the Zoom App

Open the Zoom Marketplace

Visit the Moment listing on Zoom Marketplace or search for "Moment" in the Zoom App Marketplace.

Click "Add"

Click the Add button on the Moment listing page. You will be prompted to authorize the app. Moment requests the following permissions:

In-Meeting access — allows the app to run as a sidebar panel inside your Zoom meetings and receive meeting events (reactions, participant changes).

Authorize

Review the permissions and click Authorize. Moment will be added to your Zoom account. You can now open it from the Apps tab in any Zoom meeting.

Install the Companion

Download the Companion

Download the Companion app for your platform from the GitHub Releases page:

Run the Companion

Double-click the downloaded file to run it. The Companion starts a local WebSocket server on your machine and waits for capture commands from the Zoom App sidebar.

On macOS, you may need to right-click and choose Open the first time, then allow it in System Settings → Privacy & Security.

Note: The Companion runs entirely on your local machine. It does not send any data to external servers. Screenshots are saved locally to your computer.

Verify the connection

Open a Zoom meeting and click the Apps button in the meeting toolbar, then select Moment. The sidebar will show the connection status — you should see "Companion: Connected" in the status bar at the top.

2. Usage

Moment runs as a sidebar panel inside your Zoom meetings. Once both the Zoom App and Companion are connected, screenshots are captured automatically based on your configured triggers.

Opening Moment in a Meeting

During a Zoom meeting, click the Apps button in the bottom toolbar, then select Moment. The Moment sidebar panel will appear on the right side of your meeting window.

Screenshot Triggers

Moment supports three types of screenshot triggers:

Reaction Capture

When any participant sends an emoji reaction during the meeting (clap, heart, thumbs up, etc.), Moment automatically captures a screenshot. You can configure which reactions trigger a capture in the sidebar settings. A 5-second cooldown prevents duplicate captures from rapid reactions.

Peak Detection

Moment tracks the number of participants in the meeting. When the participant count reaches a new maximum (e.g., going from 8 to 9 participants), a screenshot is automatically captured. This is useful for recording peak attendance. A 2-minute cooldown applies between peak triggers.

Manual Capture

Click the Capture button in the Moment sidebar at any time to take an instant screenshot. This is always available regardless of trigger settings.

Trigger Settings

Use the toggle switches in the sidebar to enable or disable each automatic trigger (Reaction Capture and Peak Detection). You can also select which specific emoji reactions should trigger a capture.

Moments List

All captured screenshots appear in the sidebar as a chronological list with thumbnails. Each moment shows the trigger type (reaction, peak, or manual) and timestamp. You can click a thumbnail to preview it or delete unwanted captures.

Meeting Archive

Every meeting is automatically archived to a folder on your computer. The default location is ~/Moment/{meeting-topic}-{date}/. Each archive contains:

archive.html — a self-contained HTML viewer with a timeline of events (participant joins/leaves, reactions, speaker changes) and a screenshot gallery. Open it in any web browser.
archive.json — raw event data in JSON format for programmatic access.
images/ — folder containing all captured PNG screenshots with descriptive filenames.

Settings

Open the settings panel in the sidebar to configure:

Save location — change where meeting archives are stored on your computer.
Capture mode — choose between capturing the Zoom window only, the entire screen, or the video area with custom margins.
Allowed reactions — select which emoji reactions should trigger automatic captures.

How it works: The Moment Zoom App runs inside your meeting as a sidebar panel (iframe). It uses the Zoom Apps SDK to listen for meeting events (reactions, participant changes, speaker changes). When a trigger fires, it sends a capture command over a local WebSocket connection to the Companion app running on your computer. The Companion takes the screenshot using your operating system's native screenshot tool and saves it locally.

3. Removing the App

Remove the Zoom App

Go to marketplace.zoom.us and sign in.
Click Manage → Added Apps (or Installed Apps).
Find Moment in the list.
Click Remove next to Moment.
Confirm the removal.

After removal, Moment will no longer appear in the Apps menu during your Zoom meetings.

Remove the Companion

macOS: Move the Moment Companion app to the Trash. If you enabled auto-start, remove the launch agent by deleting ~/Library/LaunchAgents/space.gtools.moment-companion.plist.
Windows: Delete the moment-companion-win-x64.exe file. If you added it to startup, remove it from your Startup folder.

What happens to your data

All your data stays on your computer. Moment does not store any data on external servers. Screenshots, archives, and meeting data are saved locally in your ~/Moment/ folder (or your configured save location).

When you remove the Zoom App and Companion:

Screenshots and archives are preserved. All previously captured screenshots and meeting archives remain in your local ~/Moment/ folder. Nothing is deleted.
Configuration is preserved. Your settings file (~/.moment-config.json) remains on your computer. You can delete it manually if you no longer need it.
No cloud data to delete. Moment does not upload any data to the cloud. There are no remote accounts, databases, or stored information to clean up.
Zoom permissions are revoked. Once you remove the Zoom App, Moment no longer has access to any meeting events or data from your Zoom account.

To completely remove all Moment data from your computer, delete the following:

~/Moment/ — all meeting archives and screenshots
~/.moment-config.json — configuration file
The Companion application file