Deploy with Microsoft Intune

Microsoft Intune can manage Apple TV (tvOS) devices, install Billboard, and configure each screen automatically with an app configuration policy. As with any MDM, Billboard reads a set of managed key/value settings on launch, so screens go straight to their gallery with no code typed 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'll lock screens with Single App Mode, first prepare each Apple TV's screen saver, sleep and update settings — 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 tab. The manifest URL is always https://getbillboard.app/m/<CODE>.
• {{devicename}} is an Intune token that inserts each Apple TV's own name, so every screen is labelled correctly. It's optional.

That's all most rollouts need. If you prefer to paste XML instead of using 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; on launch the app reads dataURL and shows the gallery immediately. Update the code in the policy later and screens follow on their next check-in.

Where settings actually live

The gallery's content and look — media, timings, AirPlay panel text, Wi-Fi step, tint, opacity, clock and notices — are all configured in your Billboard dashboard and delivered to every screen automatically. Intune's job is just 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 per device or site — for example 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 intended gallery, with no dash.