For the complete documentation index, see llms.txt. This page is also available as Markdown.

Install on Android (Display / Smart TV)

With Room System, Mago turns an Android display or Smart TV into a fully independent meeting room. USB audio and video peripherals provide the conferencing hardware. The room calendar is displayed on screen, meetings can be joined or started with a single tap, and a wireless Touch Controller lets anyone in the room manage the session.

Installation steps

1

Check hardware and peripherals

Verify that your device (Android display, Smart TV, GoogleTV, AndroidTV, or FireTV) is on the Android Displays / Smart TVs devices list. Connect a USB videobar or separate USB camera, microphone, and speaker before launching Mago so they are detected correctly on first startup.

2

Prepare the Touch Controller

Wireless Touch Controller

You will use an iPad (iPadOS 13+) or Android tablet (Android 10.0+, minimum resolution 1024x600) as a wireless touch controller by installing the Mago Controller app from the App Store or Google Play. See Wireless touch controllers for instructions. The wireless touch controller tablet requires an active Wi-Fi internet connection.

3

Prepare the network

Connect the device to wired Gigabit Ethernet. Verify that the connection provides at least 2 Mbps of internet bandwidth. Configure firewall rules and FQDN allowlisting according to the Network requirements. Proxy connections are not supported.

4

Prepare wireless screen sharing

Mago Link allows any user to share their screen by visiting magolink.com from a browser on their laptop or mobile. No app install is required. Verify that the network meets the requirements described in Mago Link.

5

Authorize the Mago app in your organization

Before Mago can access room calendars and video conferencing services on behalf of your organization, a tenant administrator must grant consent to the Mago application in your identity or services provider, such as Microsoft 365 or Google Workspace.

This is a one-time operation that authorizes Mago to request the permissions it requires, such as reading calendar events and authenticating meeting participants.

Select your provider below and follow the setup steps.

When using Mago with Microsoft 365 room resources and users, the Mago app for display and Mago mobile app access Microsoft 365 services through the Microsoft Graph and Azure Communication Services APIs. To enable these features, a tenant administrator must grant consent to the Mago enterprise application.

Add the Mago application to your tenant

Open admin.mago.io and sign in with a Microsoft 365 account that has Global Administrator, Application Administrator, or Cloud Application Administrator privileges. When prompted, review the requested permissions and select "Accept" on behalf of your organization. The Mago application is now registered in your tenant.

To review and grant admin consent to the required scopes in the Mago application permissions:

  • Open the Azure portal and sign in with a Microsoft 365 Administrator account.

  • Go to Microsoft Entra ID > Enterprise Applications (or search directly for "Enterprise Applications").

  • Under the Application list, search for "Mago" (Application ID 17781659-6867-4c77-9ba3-40670305181c).

  • Enter the Mago application, go to Security > Permissions and verify that admin consent has been granted to the required scopes. To grant admin consent to all the required scopes, click the "Grant admin consent for YourCompanyName" button.

See Microsoft 365 for Advanced consent options and the full list of Required features and scopes.

Prepare the room resource and calendar

A room resource account is required for calendar integration and instant meeting hosting. Create and provision the account in your calendar provider before proceeding.

  • Microsoft 365 — create and provision a room resource account, grant the required OAuth scopes, and run the PowerShell command to correctly display meeting titles — see the full guide here: Microsoft 365 calendar

  • Google Workspace — create a service account for conference room calendars and configure resource delegation — see the full guide here: Google Workspace calendar

Prepare video conferencing

With Room System, the room has its own identity and can join meetings independently. The configuration depends on the video conferencing provider you plan to use. BYOM User Join is also available to users connected to the room. Complete the steps for each provider that applies to your deployment.

Guest Join (ID and Passcode)

Guest Join is available out of the box. The room joins as a guest and always goes to the lobby. No additional setup is required.

Room Join (Authenticated Calls) and Host Instant Meetings

To enable Room Join and Host Instant Meetings, which allow the room to bypass the lobby, appear with its own identity, and start new meetings as a host, you will configure the following:

  • Install the Azure Communication Services service principal in the tenant

  • Provision the room resource with a Microsoft Teams license

See Authenticated Calls with Microsoft Teams for the full procedure.

User Join (BYOM Authenticated Calls)

Regardless of the room configuration, User Join (BYOM Authenticated Calls) is always available.

When a user connects to the room with their personal device and starts a meeting, their user identity takes precedence over the room identity for the duration of the connection. Once the user disconnects, the room reverts to its own join mode.

6

Prepare video conferencing

With Room System, the room has its own identity and can join meetings independently. The configuration depends on the video conferencing provider you plan to use. BYOM User Join is also available to users connected to the room. Complete the steps for each provider that applies to your deployment.

Guest Join (ID and Passcode)

Guest Join is available out of the box. The room joins as a guest and always goes to the lobby. No additional setup is required.

Room Join (Authenticated Calls) and Host Instant Meetings

To enable Room Join and Host Instant Meetings, which allow the room to bypass the lobby, appear with its own identity, and start new meetings as a host, you will configure the following:

  • Install the Azure Communication Services service principal in the tenant

  • Provision the room resource with a Microsoft Teams license

See Authenticated Calls with Microsoft Teams for the full procedure.

User Join (BYOM Authenticated Calls)

Regardless of the room configuration, User Join (BYOM Authenticated Calls) is always available.

When a user connects to the room with their personal device and starts a meeting, their user identity takes precedence over the room identity for the duration of the connection. Once the user disconnects, the room reverts to its own join mode.

7

Sign in or Sign up to Mago Admin Center

If you do not already have an account, register at admin.mago.io. You will also need a valid Mago license key. If you do not have one, you can select a free trial during device activation.

8

Install Mago

Install Mago on the device using one of the following methods depending on your device type:

  • Google Play Store — available on GoogleTV and AndroidTV devices, search for "Mago for Display" and install (Google Play store link here)

  • Amazon Appstore — available on FireTV devices, search for "Mago for Display" and install (Amazon Appstore link here)

  • Direct APK — download the APK from admin.mago.io/download-software and sideload it on the device

After installation, launch the Mago app.

9

Grant required permissions

On first launch, Mago will request permissions for microphone, camera, networking, local discovery, and display over other apps. Grant all permissions when prompted. You can review permissions later via Settings → Apps → Mago → Permissions.

10

Disable "Pause app activity if unused"

Android may automatically restrict apps that have not been used recently, revoking permissions or suspending background services. To prevent this from interrupting screen sharing, pairing, or meeting startup, disable this option on the device via Settings → Apps → Mago.

11

Activate the device and complete the setup wizard

On first launch, Mago displays an activation screen with a QR code or a 6-digit code. Open admin.mago.io in a browser, go to Devices > Activate, and follow the on-screen steps to activate. Name the device when prompted. The device will appear under Devices in the Admin Center once activation is complete.

During the activation wizard, complete the following configuration steps.

  • Connect the calendar. Select the calendar provider (Microsoft 365 or Google Workspace) and connect the room resource account you prepared. Complete the authentication flow and continue to the next step.

  • Configure video call providers. For each video conferencing provider you plan to use (Microsoft Teams, Zoom, Cisco Webex, Google Meet, Mago Meet), enable the features that apply to your deployment: Guest Join with meeting ID and Passcode, Authenticated Calls, and Host Instant Meetings. The provider credentials and licenses you prepared are required to complete this configuration.

12

Configure policies

In Mago Admin Center, go to Policies and create or assign a policy for the device. Configure appearance, device settings, and any restrictions as needed. The device will update over the air.

13

Verify

  • Confirm date and time are correct

  • Verify network connectivity

  • Test wireless screen sharing

  • Test AV peripherals

Last updated

Was this helpful?