January 27, 2023

Describe Your AppleTV Media Using ATVFiles

Posted April 10, 2008 at 10:47pm by iClarified · 31281 views
These are instructions on how to give descriptions to the media on your AppleTV for use with the ATFiles plugin.

Notice how when navigating through your media only the title and size is displayed at the bottom left. We can change that!
Describe Your AppleTV Media Using ATVFiles

Step One
You must of course have the ATVFiles plugin installed before attempting this tutorial. You can find instructions on how to do that here

Step Two
Launch TextEdit from your Applications folder
Describe Your AppleTV Media Using ATVFiles

Step Three
Select Make Plain Text from the Format Menu.
Describe Your AppleTV Media Using ATVFiles

Step Four
Copy and Paste the following into your TextEdit window:







Step Five
Now go through each tag and modify the content between the tags to accurately describe your media.

For example:
Change Title by replacing Title with the name of your media. ie 2012 Doomsday

Important Notes:
- The very first media tag() has set possible values. They are: "Song", "Music Video", "Podcast", "Movie", "TV Show", "Audio Book". The default type is Movie.
- Duration is only to be used as an override if the QuickTime scanning gets it wrong, otherwise it should not be used.
- Rating will display graphics for the usual ones (R, TV-PG, etc.)
- All tags are optional. Just omit the tag if you don't want or need it !

Step Six
Here is an example of what the input would look like for the 2012 Doomsday Movie.
Describe Your AppleTV Media Using ATVFiles

Step Seven
Select Save from the File Menu when you are done inputing your description.
Describe Your AppleTV Media Using ATVFiles

Save the file to your desktop with the exact name of the media file on your AppleTV but with an xml extension. For example if the filename on your AppleTV is 2012 Doomsday.avi then save your description as 2012 Doomsday.xml.
Describe Your AppleTV Media Using ATVFiles

If asked to confirm your file extension the click the Use .xml button.
Describe Your AppleTV Media Using ATVFiles

Step Eight
Now all you have to do is copy the xml file on your Desktop to the exact same folder as your media file on the AppleTV. ATVFiles will automatically retrieve your description and display it on the AppleTV.
Describe Your AppleTV Media Using ATVFiles

Notice the blank image above your description? Learn how to add cover art by following this tutorial.
Add Comment
Would you like to be notified when someone replies or adds a new comment?
Yes (All Threads)
Yes (This Thread Only)
iClarified Icon
Would you like to be notified when we post a new Apple news article or tutorial?
You must login or register to add a comment...
Thomas - June 7, 2008 at 7:39pm
ATVFiles does not support those as far as I know. Those rating limits are something for the built-in movie player only.
Thierry - June 7, 2008 at 6:16pm
Hello, I enabled parental controls with "TV-PG" threshold in the AppleTV general settings, with a four digit code.

I set "R" ratings to some TV episodes and the "R" icon is well displayed by ATVFiles, below the cover art, but there is no prompt for the 4-digit code...

Does ATVFiles really support TV/Movies ratings? What went wrong?

Thank you for your help.

Thomas - April 27, 2008 at 12:55am
I uploaded a new version to the google code website. It no longer is required to have movies sorted per movie in a separate folder. It should now also work with one big unsorted folder. http://code.google.com/p/appletvdatamaker/
Thomas Silcox-Childs
Thomas Silcox-Childs - November 3, 2009 at 2:54pm
Anyone tried this app AppletvDataMaker lately? It does xml for me but writes zero byte image files. Cover Art does not work. Any advice would be appreciated.
Thomas - April 14, 2008 at 5:43am
moe: it gets the TV data from tvrage.com as that was the first one I found to have decent data and an open API to use. Never looked at others (including Yahoo).
5 More Comments
Recent. Read the latest Apple News.
Tutorials. Help is here.
Where to Download macOS Ventura
AppleTV Firmware Download Locations
Where to Download iPod touch Firmware Files From
Where To Download iPad Firmware Files From
Where To Download iPhone Firmware Files From
Deals. Save on Apple devices and accessories.