Beam Client: Installation, Deployment, and Configuration Guide

Overview

This guide provides a full walkthrough for installing and deploying the ScreenMeet Beam Client across your organization. It supports both manual installs and enterprise-scale rollouts using deployment scripts or MDM tools. It also covers how to configure or change Beam settings post-installation for both Windows and macOS.

1. Installing the Beam Client

Windows (Manual Install)

1. Download the Windows installer:
   ScreenMeet.msi

2. Follow the guided wizard:

   • Choose install location

   • Select whether to create desktop or Start menu shortcuts

   • Choose features: Remote Support (attended) and/or Beam (unattended)

   • Configure update preferences

3. When prompted:

   • Enter the Device Group Key

   • Select authentication method: noauth, native, or password

   • Optionally add label, tags, hide UI, and enable logging

4. Complete the install. The device will appear in the corresponding Beam Group within the ScreenMeet console.

macOS (Manual Install)

1. Download the macOS installer:
   ScreenMeetBeam.pkg

2. Run the installer and approve permissions for:

   • Screen Recording

   • Accessibility

3. After install, click the Beam icon in the menu bar and choose Configure

4. In the configuration window:

   • Paste in the Device Group Key

   • Select authentication method

   • Toggle options for:

     • Hide UI during Beam sessions

     • Check for updates

   • Confirm permissions are granted

5. Click Save Preferences

The macOS device will now appear in your Beam Group in the console.

2. Enterprise Deployment

Windows (Command-Line Deployment)

Deploy using command-line tools like SCCM, RMM, or Intune.

Example:

msiexec /i ScreenMeet.msi /quiet ADDLOCAL="SupportFeature,BeamFeature" \
BEAMGROUPKEY="your-group-key" BEAMAUTHTYPE="password" BEAMPASSWORD="secure123" \
BEAMHIDEUI="1" BEAMFILTERLABEL="Laptop-IT" BEAMFILTERTAGS="it,windows"

Key Parameters:

The Device Group Key links the device to the correct organizational access group.

macOS (MDM Deployment)

1. Upload the ScreenMeetBeam.pkg to your MDM

2. Use a pre-install script to generate the device configuration plist:

PLISTFILE="/Users/Shared/ScreenMeetBeam/Config-000000.plist"
cat > "$PLISTFILE" <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
  <key>authMode</key><string>noauth</string>
  <key>groupKey</key><string>your-group-key</string>
  <key>hideUI</key><true/>
  <key>autoupdate</key><false/>
  <key>userCanControlAutoupdate</key><false/>
  <key>installMethod</key><string>mdm</string>
  <key>installSoftware</key><string>kandji</string>
  <key>label</key><string>mac-laptop-1</string>
  <key>tags</key><string>mac,finance</string>
</dict>
</plist>
EOF

3. Optional: Add an audit script to detect if Beam is missing and trigger install

Your exact scripts may vary depending on your MDM (Jamf, Kandji, Intune, etc.)

3. Changing Beam Settings After Installation

Windows

Open the Beam Configuration app (search from Start Menu).

• General Tab:

  • Change group key

  • Temporarily disable Beam without uninstalling

• Security Tab:

  • Change authentication method

• Advanced Tab:

  • Enable/disable updates

  • Enable logging for troubleshooting

Click Apply Changes to save.

macOS

Click the Beam icon in the top-right menu bar and choose Configure.

You will see:

• Device Group Key field and validation

• Client Authentication Method dropdown

• Options to:

  • Hide UI during sessions

  • Check for updates

Also confirms whether Screen Recording and Remote Control permissions are granted.

Click Save Preferences to apply changes.

Summary