Zoom app guide – LiveControl Zoom

This guide explains how to add, use, and remove the LiveControl Zoom app with your Zoom account.

Adding the app

  1. Install LiveControl Zoom on your Windows PC (run the installer or copy the application files).
  2. Open the app. In the main window, find the OAuth (marketplace) section.
  3. Click Sign in with Zoom. Your browser will open the Zoom authorization page.
  4. Sign in to Zoom if prompted, then review the permissions and click Authorize to allow the app to join meetings on your behalf.
  5. You will be redirected back to the app (via http://localhost:38472/callback). The app will show that you are signed in. You only need to do this once per machine; the app stores tokens locally and can refresh them.

Note: If you use the optional Runner for scheduled joins, ensure the app’s config has the correct database path and timing (pre-launch minutes, time window). Run the credential setup tool once with your Zoom OAuth app’s Client ID and Secret if you use JWT for development.

Using the app

Manual join

  1. Enter the Meeting ID and Passcode (if required).
  2. Optionally set Display Name (e.g. “LiveControl Encoder”).
  3. If you signed in with Zoom, the app will use your OAuth tokens (ZAK or join token) when joining. Otherwise, enter an SDK JWT and click Auth first.
  4. Click Join meeting. The app will join with audio and video on and Original Sound enabled.

Scheduled (automatic) join

  1. Configure the app: set Database path to your SQLite database that has a table (e.g. Dashboard) with event date/time, Zoom meeting ID, and passcode columns. Set Pre-launch (min) and Time window (min) as needed.
  2. Click Save to config.
  3. Schedule the Runner (e.g. LivecontrolZoomAuto.Runner.exe) to run on a schedule (e.g. Windows Task Scheduler) so it runs periodically. The Runner reads upcoming events from the database and launches the main app with --join <meetingId> [passcode] at the right time.
  4. When the main app is launched by the Runner, it will auto-join the meeting after a short delay. Ensure you have signed in with Zoom (or have a valid JWT) so the Runner can obtain ZAK or a join token for the meeting.

For more on ZAK vs join token (OBF): the app uses ZAK when available (unattended join). If ZAK is not available, it uses a per-meeting join token (OBF); in that case the Zoom user may need to be in the meeting or be the host.

Removing the app

  1. Revoke Zoom authorization: In the app, click Sign out in the OAuth section. Optionally, go to your Zoom account settings on the web, find “Connected applications” or “Authorized apps,” and remove LiveControl Zoom.
  2. Stop the Runner: If you use Windows Task Scheduler (or similar) to run the Runner, disable or delete that task.
  3. Uninstall the application: Use Windows “Add or remove programs” (or equivalent) to uninstall LiveControl Zoom, or delete the application folder.
  4. Remove local data (optional): Delete the app’s config file (LivecontrolZoomAuto.config.json) and encrypted credential/token files from the app directory if you want to remove all stored settings and tokens.

After removal, the app will no longer have access to your Zoom account. You can reinstall and sign in again later if needed.

Support

For help, see our Support page or contact support@livecontrol.io.