How to deploy Ditto tvOS Receiver in Single App Mode
Overview:
Single App Mode locks an Apple TV into running one designated app so users can’t exit or navigate away. Even after a reboot, the Apple TV returns directly to the app without showing the Home screen. Organizations can do this with the Ditto tvOS Receiver app. Single App Mode is perfect for dedicated environments like:
- Education (e.g., classrooms sharing content seamlessly)
- Enterprise & Meeting Spaces (consistent meeting setup)
- Kiosks & Public Displays (secure, purpose-driven usage)
General Requirements and Prerequisites
Ensure the following before you begin:
- Apple TVs are supervised (via MDM, Apple School Manager or Apple Configurator).
- The Ditto tvOS Receiver app is installed on each Apple TV.
- You have administrator access to your MDM.
- Apple TVs have network connectivity to reach your MDM server and Ditto services.
Enabling Single App Mode by MDM Vendor:
- Microsoft Intune
- Jamf School
- Jamf Pro
- Cisco Meraki
- Mosyle
- Apple School Manager (ASM) + Apple Configurator
- Apple Configurator
- Hexnode
- Kandji
Microsoft Intune
Intune supports Apple TV management via Automated Device Enrollment (ADE) through Apple Business or School Manager—ensuring device supervision and MDM enrollment. The Microsoft support article on this topic can be found here.
Steps:
-
In the Intune Admin Center, ensure your Apple TVs are enrolled via ADE.
-
Go to Devices > tvOS > Configuration Profiles.
-
Create a new profile; select Kiosk (Single App Mode) or use Settings Catalog to find the Kiosk setting.
-
Choose Store App and enter the Ditto app’s App Store URL—or use “Built-In App” plus the bundle ID: com.squirrels.dittoatv2
-
Assign the profile to target Apple TV devices.
-
Save and sync your devices.
Jamf School
Jamf School offers a straightforward wizard-based setup for Single App Mode. The Jamf support article on the topic can be found here.
Steps:
-
Go to Profiles > Configuration Profiles > Create Profile.
-
Select tvOS, name the profile, and save to open the editor.
-
Choose Single App Mode payload; enable Lock device to a specific app and select Ditto from the dropdown.
-
Optionally configure enforced options (e.g., disable touch input, screen saver).
-
Scope the profile to your Apple TV group.
-
Save the profile to apply.
Need help deploying the Ditto tvOS Receiver app to your Apple TVs with Jamf? Follow this guide.
Jamf Pro
Jamf Pro supports robust Single App Mode controls via Configuration Profiles. The Jamf support article on the topic can be found here.
Steps:
-
Navigate to Devices > Configuration Profiles > New.
-
Set up a profile with platform = tvOS.
-
Add the Single App Mode payload; click Configure.
-
Choose Specify Bundle ID and enter:
com.squirrels.dittoatv2
-
Optionally enforce additional settings (e.g., disable touch, auto-lock).
-
Scope to Apple TVs where Ditto is installed.
-
Save and deploy.
-
Troubleshooting tip: If encountering "Guided Access Unavailable," ensure the Ditto app is installed before the Single App Mode profile applies. Use a smart group to filter by app-installed status.
Need help deploying the Ditto tvOS Receiver app to your Apple TVs with Jamf? Follow this guide.
Cisco Meraki
Meraki’s Systems Manager enables Single App Mode through a simple payload configuration. The Cisco support article on the topic can be found here.
Steps:
-
Open Meraki Dashboard and go to Systems Manager > Profiles.
-
Add a new profile with platform tvOS.
-
Include a Single App Mode payload.
-
Enter the Ditto bundle ID (com.squirrels.dittoatv2).
-
Assign to Apple TV devices and save to deploy.
Need help deploying the Ditto tvOS Receiver app to your Apple TVs with Cisco Meraki? Follow this guide.
Mosyle
Mosyle allows setup via its profile configuration interface.
Steps:
-
Log in to the Mosyle portal.
-
Navigate to Management > Profiles > Add Profile.
-
Select tvOS, then add a Single App Mode payload.
-
Input the bundle ID: com.squirrels.dittoatv2.
-
Scope to Ditto-enabled Apple TVs.
-
Save and apply the profile.
Need help deploying the Ditto tvOS Receiver app to your Apple TVs with Mosyle? Follow this guide.
Apple School Manager (ASM) + Apple Configurator
When devices are supervised and enrolled in ASM, you can fully manage Single App Mode via Apple Configurator.
Steps:
-
Pair the supervised Apple TV with a Mac running Apple Configurator 2.
-
In Configurator, navigate to Actions > Advanced > Start Single App Mode.
-
Choose Ditto as the designated app.
-
To stop using Single App Mode, repeat the action and select Stop Single App Mode.
Apple Configurator
For direct management of supervised Apple TVs, Configurator offers a manual toggle. The Apple support article on the topic can be found here.
Steps:
-
Connect or network pair the Apple TV with your Mac.
-
Ensure it shows as supervised.
-
Select Actions > Advanced > Start Single App Mode and choose Ditto.
-
To stop using Single App Mode, use Actions > Advanced > Stop Single App Mode.
Hexnode
Hexnode UEM supports Single App Mode via its device policies interface. The Hexnode support article on the topic can be found here.
Steps:
-
In Hexnode UEM, go to Policies > New Policy > tvOS.
-
Add a Single App Mode payload.
-
Input the bundle ID: com.squirrels.dittoatv2.
-
Assign the policy to relevant Apple TVs.
-
Save and push the policy.
Need help deploying the Ditto tvOS Receiver app to your Apple TVs with Hexnode? Follow this guide.
Kandji
Kandji refers to Single App Mode as App Lock. This feature restricts a tvOS device to a single app and ensures the device always returns to that app after reboot. The Kandji support article on the topic can be found here.
Steps:
-
In Kandji, open the Blueprint assigned to your Apple TVs.
-
Add a Library Item of type App Lock.
-
Configure the payload and select Ditto Receiver as the locked app.
- If Ditto doesn’t appear, ensure it has been added to the Kandji Library via Apps & Books or as a custom app.
-
Optionally configure restrictions (disable touch, volume buttons, or screen sleep).
-
Assign the Blueprint to the Apple TVs running Ditto.
-
Kandji will push the App Lock configuration, causing those Apple TVs to launch and stay locked in Ditto.
Need help deploying the Ditto tvOS Receiver app to your Apple TVs with Kandji? Follow this guide.
Troubleshooting
-
Ditto not locking as expected
-
Ensure the app is installed before the Single App Mode profile runs—especially in Jamf Pro scenarios (use smart groups)
-
Confirm the device is supervised and enrolled correctly.
-
-
App crashes or exit occurs
-
Double-check bundle ID accuracy (e.g., com.squirrels.dittoatv2).
-
Validate that the MDM can reach the device over the network; consider a manual restart.
-
-
Unable to exit Single App Mode
-
Remove or disable the responsible profile in your MDM.
-
In Configurator, use Stop Single App Mode to reset behavior.
-
Best Practices & Tips
-
Pilot deployment on one Apple TV before mass rollout.
-
Sequence installation: Install Ditto first, then apply Single App Mode—avoid configuration race conditions.
-
Plan for exit: Document removable or changeable configurations in case of future updates.
-
Network: Ensure consistent and managed connectivity during and after profile deployment.
-
Stay updated: Keep MDM and tvOS versions current to ensure compatibility.
Summary
Single App Mode ensures Apple TVs with Ditto remain dedicated and reliable—ideal for streamlined classroom sharing, conferencing or kiosk use.
Looking to mass deploy Ditto Windows Receiver? Find instructions here.
Need assistance? Reach out to Ditto Support via help.airsquirrels.com.