Skip to main content

Apple TV Wallpaper issue, help!

  • September 9, 2025
  • 11 replies
  • 225 views

AmanCognita
Forum|alt.badge.img+1

Hi

 

I’m trying to set a wallpaper for Apple Tvs in a school. I’ve set a configuration profile which locks the Apple TV in the conference display mode. I’ve also created a smart device group where i’ve uploaded a test jpg file, but it doesn’t want to pickup the wallpaper.

 Does anyone have have suggestions?

11 replies

Forum|alt.badge.img
  • New Contributor
  • September 9, 2025

I am facing exactly same issue


Rick_Goody_Jamf
Forum|alt.badge.img+6

check out this app https://marketplace.jamf.com/details/exhibit

 

can provide more than just a single wallpaper


AmanCognita
Forum|alt.badge.img+1
  • Author
  • New Contributor
  • September 10, 2025

check out this app https://marketplace.jamf.com/details/exhibit

 

can provide more than just a single wallpaper

This looks like a good app Thanks, managed to download it, but looks confusing to configure, how do i upload photos? 


Rick_Goody_Jamf
Forum|alt.badge.img+6

So you would need to deploy via MDM and deploy managed app config with it.

 

Here are all the various options - https://github.com/NU-ITS/Exhibit/blob/master/docs/app-config.md

 

As part of the process, you need to host a CSV file somewhere that the Apple TV can contact on a web server. In the past I have seen people just host it on a Windows Server and turn on IIS

In that CSV file, you can define where the images are stored. That way the device will pull the images directly rather than via MDM commands and configs. Also, you can have multiples and use it like a digital signage

Check out their demo content - https://github.com/NU-ITS/Exhibit/blob/master/docs/demo.md


AmanCognita
Forum|alt.badge.img+1
  • Author
  • New Contributor
  • September 10, 2025

So you would need to deploy via MDM and deploy managed app config with it.

 

Here are all the various options - https://github.com/NU-ITS/Exhibit/blob/master/docs/app-config.md

 

As part of the process, you need to host a CSV file somewhere that the Apple TV can contact on a web server. In the past I have seen people just host it on a Windows Server and turn on IIS

In that CSV file, you can define where the images are stored. That way the device will pull the images directly rather than via MDM commands and configs. Also, you can have multiples and use it like a digital signage

Check out their demo content - https://github.com/NU-ITS/Exhibit/blob/master/docs/demo.md

Many thanks for your help, just got it working, only other question is there a way to remove the Airplay window that appears with the images, or this a way to change the text as it suggests I’ve called the Apple TV “Apple TV”  when it’s got a different name, which will confuse users when trying to connect


Rick_Goody_Jamf
Forum|alt.badge.img+6

So all the configuration options are shown in the documentation. 
 

to change the device name you would add this key to you app config  and it will use the device name from jamf pro  

<key>edu.nebraska.ImageViewer.deviceName</key>
<string>$DEVICENAME</string>

 

if you want to remove the AirPlay window I believe it is this key

<key>edu.nebraska.ImageViewer.airplayViewHide</key>
<true/>

 

however it’s all documented on the app config docs link as above. 
 

once you are happy with your deployment and config.  Then you would push a config profile with single app mode to stay in that app


AmanCognita
Forum|alt.badge.img+1
  • Author
  • New Contributor
  • September 10, 2025

So all the configuration options are shown in the documentation. 
 

to change the device name you would add this key to you app config  and it will use the device name from jamf pro  

<key>edu.nebraska.ImageViewer.deviceName</key>
<string>$DEVICENAME</string>

 

if you want to remove the AirPlay window I believe it is this key

<key>edu.nebraska.ImageViewer.airplayViewHide</key>
<true/>

 

however it’s all documented on the app config docs link as above. 
 

once you are happy with your deployment and config.  Then you would push a config profile with single app mode to stay in that app

Cool, thank you very much for all your help, thats helped alot!


Forum|alt.badge.img
  • New Contributor
  • March 25, 2026

Hi,

I got this error after deploying the app.

“There was an issue loading the player content. Visit https://exhibit.readthedocs.org/ to get started.

 


AmanCognita
Forum|alt.badge.img+1
  • Author
  • New Contributor
  • March 26, 2026

Probably Excel, i found editing the csv files in excel very fragile, had to keep starting over, is probably best to use textedit, as Excel quietly makes some hidden changes, textedit doesn’t


Forum|alt.badge.img
  • New Contributor
  • March 26, 2026

Probably Excel, i found editing the csv files in excel very fragile, had to keep starting over, is probably best to use textedit, as Excel quietly makes some hidden changes, textedit doesn’t

Hi,

I added\edit the file thru github. Thanks for your help.
https://github.com/jaybpc-code/bpc-dd/blob/main/bpc-dd-preferences.csv


avagrace
Forum|alt.badge.img
  • New Contributor
  • March 27, 2026

This is a common headache with tvOS and configuration profiles. Often, the issue isn't the profile itself, but how the Apple TV handles the image URL or the "Conference Room Display" state.

Here are a few things to check that usually get it working:

  • Host the Image Externally: Instead of relying on a local upload, host .jpg on a secure, public-facing URL (like a web server or a public cloud bucket). MDM profiles often struggle to "push" the file if they can't reach the direct link during the initial handshake.

  • Check Resolution & Size: Apple TVs are picky about file size. Keep the image under 1MB and ensure it’s exactly 1920x1080. If it's too large, the device will often just time out and default to the standard background.

  • Refresh the Command: Sometimes the device needs a nudge. Try sending a "Blank Push" or a "Restart Device" command from Jamf after the profile is installed.

  • Conference Room Mode: Since you have it locked in Conference Room Display mode, double-check that the "Custom Message" and "Wallpaper" fields are both active in the same payload. Sometimes one won't trigger without the other.

If it still won't budge, try checking the Management Tab on one of the devices in Jamf—if the command is "pending," it's likely a network/firewall issue blocking the download of the image file.