Deploy with Microsoft Intune

Microsoft Intune can manage Apple TV (tvOS) devices, install Billboard, and set up each screen for you with an app configuration policy. Like any MDM, Billboard reads a set of managed key/value settings on launch, so screens go straight to their gallery with nobody typing a code on the TV.

Before you start: enrol your Apple TVs into Intune as tvOS devices, and add Billboard Screen as a managed store app (via Apple Business Manager / volume purchasing). The app's bundle identifier is app.BillboardScreen. If you're going to lock screens with Single App Mode, sort out each Apple TV's screen saver, sleep and update settings first. See Prepare the Apple TV first.

1. Add the app

1. In the Microsoft Intune admin center, go to Apps → All apps → Add.
2. Add Billboard Screen as an Apple store app (or from your Apple VPP tokens) for the tvOS platform.
3. Assign it as Required to the device group containing your Apple TVs so Intune installs it automatically.

2. Create an app configuration policy

1. Go to Apps → App configuration policies → Add → Managed devices.
2. Give it a name, choose the tvOS/Apple TV platform, and select Billboard Screen as the targeted app.
3. Under configuration settings, choose Use configuration designer (or enter XML) and add the keys below.

At minimum, set the manifest URL for the gallery this group should show:

• Replace ABCD2345 with your gallery code (letters and numbers only, no dash), from the gallery's Connect panel. The manifest URL is always https://getbillboard.app/m/<CODE>.
• {{devicename}} is an Intune token that drops in each Apple TV's own name, so every screen is labelled correctly. It's optional.

That covers most rollouts. If you'd rather paste XML than use the designer, use the same property-list format shown in the Jamf guide.

3. Assign and deploy

Assign the policy to the same device group as the app. Intune installs Billboard and delivers the configuration, and on launch the app reads dataURL and shows the gallery straight away. Change the code in the policy later and screens follow on their next check-in.

Where settings actually live

The gallery's content and look, so media, timings, AirPlay panel text, Wi-Fi step, tint, opacity, clock and notices, all get set in your Billboard dashboard and pushed to every screen automatically. Intune's only job is to point each screen at the right gallery with dataURL. You don't re-enter the look here.

If you need some screens to differ by device or site, say a different Wi-Fi network name per building, managed values override the gallery. See Advanced: overriding a setting per device or site in the Jamf guide. The same keys work in Intune.

Troubleshooting

• The TV still shows the welcome screen. The policy didn't reach the device, or dataURL is missing. Confirm the app configuration policy targets the tvOS app and the same group as the app assignment, then sync the device.
• Type mismatches. Make sure dataCheckTimer and imageTimer are Integer, and toggles like showClock are Boolean, not strings.
• Wrong content. Check the gallery code in dataURL matches the gallery you meant, with no dash.