Knowledge Base/Boxee Box by D-Link/Local Files

Creating an NFO file

marcel hass
posted this on Mar-29 04:26 am

*Please note that NFO files will only work with Boxee version 1.1.0.18xxx and above (Settings >System)

Nfo files can be used to provide data for a video file in Boxee, in particular they are helpful if the information data such as the description of the plot for that particular file does not exist on IMDB or TVDB.
 
The Nfo descriptor files are based on an XML structure, different for each Media content.

Nfo file will be implemented into the library on an automatic scan ,if you manually identify a movie it will take first the folder.jpg if available otherwise it will take the relevant information from IMDB/TVDB.

NFO for Movies  

  • One folder containing multiple movies - the movie nfo filename must be the same as the media filename. (for example: unbreakable.mkv >> unbreakable.nfo)
  • If the movie has its own seperate folder, the nfo file may be named “movie.nfo”.


 
Supported Movie .nfo descriptor file structure (Template):

Here is an example of an NFO created to display Avatars


 <movie>
   <title>Avatar</title>
   <rating>8.2</rating>
   <year>2009</year>
   <outline>A paraplegic marine dispatched to the moon Pandora on a unique mission becomes torn between following his orders and protecting the world he feels is his home.</outline>

   <runtime>162min</runtime>    

<thumb>http://ia.media-imdb.com/images/M/MV5BMTYwOTEwNjAzMl5BMl5BanBnXkFtZ... </thumb>
   <mpaa>PG-13</mpaa>
   <id>tt0499549</id>
   <trailer></trailer>
   <genre>Action</genre>
   <director>James Cameron</director>
   <actor>
       <name>Paul Begala</name>
       <role>Himself</role>
   </actor>
   <actor>
       <name>John Kerry</name>
       <role>Himself</role>
   </actor>
</movie>


 
** The id is the tt number from the IMDB e.g http://www.imdb.com/title/tt0499549/  if no ID is specified then Boxee will display the relevant details from the NFO in the Movie Library.
 
NFO TV Shows / Episodes

An nfo file may be specified either for Tv show seasons or a specific episodes (or both).

An nfo for an episode must be named exactly the same as the media file name just with an .nfo extension.

Please note that an Episode.nfo will overwrite Tvshow.nfo fields

Supported Episode .nfo descriptor file structure (Template):

<episodedetails>
   <title>My TV Episode</title>
   <rating>10.00</rating>
   <season>2</season>
   <episode>1</episode>
   <plot>the best episode in the world</plot>
   <runtime>21 min</runtime>
   <aired>2000-12-31</aired>
</episodedetails>


When creating an Nfo file for a TV show, it must be named as “tvshow.nfo” (exact), and it must be located in the root directory of the TV Show.

There can only be only ONE tvshow.nfo descriptor per series. If there are several tvshow.nfo files spread inside the hierarchy of the directories, the parent folder closest to the current folder is picked. --this may lead to inconsistencies in resolving and it is highly suggested that there will be only one tvshow.nfo


The folder.jpg residing in the root folder will be the default option displayed or you can take the full path to the folder image form the thumb parameter in the nfo descriptor e.g <thumb>smb://drobo-fs/tvshows/chuck/folder.jpg</thumb>

Please note that this format <thumb>my WD passport 500/tvshows/chuck/folder.jpg</thumb> or<thumb>mnt/tmp/98874442222/tvshows/chuck/folder.jpg</thumb>will not work.

Supported TV Show .nfo descriptor file structure (Template):

<tvshow>
  <title>MythBusters</title>
  <plot>So exactly how hard is it to find a needle in a haystack, anyway? And can water dripping on your forehead really drive you nuts? Those are the kinds of questions, myths and urban legends that are put to the test in this humorous series to find out which ones hold water (and keep it from dripping on your forehead and driving you insane).</plot>
  <thumb>http://thetvdb.com/banners/graphical/73388-g3.jpg </thumb>
  <id>73388</id>
  <genre>Reality</genre>
  <actor>
      <name>Robert Lee</name>
      <role>USA Narrator</role>
      <thumb></thumb>
  </actor>
  <actor>
      <name>Adam Savage</name>
      <role></role>
      <thumb></thumb>
  </actor>
</tvshow>

** The id is the number from TVDB e.g http://thetvdb.com/banners/graphical/73388-g3.jpg

 

Comments latest first

Thomas Kingo
boxee

...and my post got cut of.

What I meant to say was that you are welcome to give it a try if you have the need for NFO files (I did. That's why it's there ;) You can find it here: http://nfo.sprocket.dk

Jun-09 2011 05:11 pm.
Thomas Kingo
boxee

Hi there.

A little off topic. I have created a small website that can help you generate NFO files for the movies the Boxee Box doesn't recognize. It's a simple search engine that searches in www.themoviedb.org

Jun-09 2011 05:05 pm.
Stephen Jesse
boxee

Quick question so am I to understand that the entire series is going to represented by a single cover are for like the box art or can you get around that by not having the nfo file in the parent directory and just have them in the season 1-10 folders. I would like to provide a brief description that is relevant to the season mot the entire series as the overall plot lines do tend to change also.

May-29 2011 01:46 pm.
Mark Wheadon
boxee

OK, so I have (for my daughter :-), .nfo files that look like

 

<episodedetails>

  <season>1</season>

  <episode>1</episode>

</episodedetails>

and mkv files of the same name (with the different extension, obviously). And a tvshow.nfo like this

<tvshow>

  <title>The Banana Splits Show</title>

</tvshow>

And if I force an identify it asks me if I want to use the NFO file -- I say yes and it identifies correctly, I tick the 'do it for all the files' and what I get is a series called the right thing, with an image (which I put in Folder.jpg), but clicking on the series results in "There are no episodes" :-(
Am I doing something wrong?

 

May-21 2011 03:00 pm.
P J
boxee

Peter you are probably better of asking for help over at http://forums.boxee.tv/forumdisplay.php?f=23

May-14 2011 06:26 pm.
Peter Bembo
boxee

I have a TV Show split in two *.iso images. I've placed them in a folder with the attached tvshow.nfo.

Am I doing something wrong? After a scan I'm getting a 1994 film named "The Silver Surfer" into Movies that is not what I have specified into the nfo file.

May-14 2011 06:22 pm.
Chris Bartels
boxee

Quick question here as well.. For the Movies .nfo file under genre if I wanted multiple entries do I comma separate them (ex. Action, Scifi, Fantasy), semicolon (ex. Action; Scifi; Fantasy;), or do I add multiple tags <genre>whatever</genre>...etc? if I use either of these methods will Boxee Box pick up the different genres?

May-14 2011 11:49 am.
P J
boxee

What goes in the <trailer> field?

May-13 2011 03:15 pm.
Robert McGeorge
boxee

Okay another riddle... What about the DVD's that just do not fit into a IMDB title like "The Three Stooges Collection" Volume One to Eight or "Disney have a laugh Volume 1" oras screwed up as I just found out "Futurama Volume 1 to 5", which does not go by the Seasons. (There was only 9 episodes in season 1 of Futurama but they put Season 1 and part of season 2 on volume 1.

May-12 2011 07:09 pm.
CasaW
boxee

What about folder.jpg for movies? Does it work like with tv shows? If there's no entry with the <thumb> tag wil the folder.jpg be recognized? Or maybe an jpg with the name of the file? And what about an nfo with just the imdb - url. they still seem to work. Or is it just cached info?

May-12 2011 02:02 am.
P J
boxee

Hm, it seems your xml parsing is overly hysterical or something: I took the first nfo file, removed the others, then copied the first one and edited the content. And then i suddenly see 3 entries as expected - even though the copied+edited file looks the same in an editor. Very odd.

May-11 2011 05:09 pm.
Randy Wilson
boxee

Not sure if it really adds anything to the conversation but I have had much better luck allowing the automatic scanning (as opposed to manually updating).

May-11 2011 04:15 pm.
marcel hass
boxee

will try and update this over the next few days

May-11 2011 04:12 pm.
P J
boxee

Better documentation may solve everything, as it is there are big amounts of guessing about this.

May-11 2011 04:03 pm.
marcel hass
boxee

Can you send me marcel@boxee.tv your NFO files for the episode and TVshow and the folder structure so i can reproduce ..

May-11 2011 03:57 pm.
P J
boxee

"The Nfo descriptor files are based on an XML structure, different for each Media content."

Btw, where is listed what is what?

Also, in your example there are listed directors and actors, but they don't seem to show up anywhere?

May-11 2011 03:56 pm.
P J
boxee

Excellent Marcel, but now there is another problem:

 

I have 3 episodes, each with their own NFO and a tvshow.nfo - after going to settings and telling it to delete media and rebooting the folder.jpg showed up, but only the first episode was listed.

Then i removed the tvshow.nfo and did the delete media, reboot and scan again but then no art was displayed, it just said the 3 episodes were unidentified?

 

Also, I'm confused about your website, i got a message that you had added a reply at http://support.boxee.tv/entries/510215 - but I can't post there, when i log in i get directed to here, at boxee.zendesk.com - very confusing.

May-11 2011 03:50 pm.
marcel hass
boxee

If a folder.jpg is in the the root folder of the Movie or TVshow then this will be displayed (no need to add the path in the NFO)..update the document to reflect the changes in this version.

May-11 2011 03:40 pm.
P J
boxee

Btw, re folder.jpg it also becomes unwieldy with an absolute path, this needs to be relative so its portable.

May-11 2011 02:34 pm.
P J
boxee

Ok, the hardcoding of folder.jpg isn't really good enough, it becomes too nerdy. It should pick it up automatically if its in the folder on the drive.

 

Content wise, you should add the ability to specify a custom background picture (instead of the stars)

 

And finally, if this entry is no longer in use, perhaps you should delete it:

http://support.boxee.tv/entries/510214-creating-an-nfo-file-for-box...

May-11 2011 02:33 pm.
Randy Wilson
boxee

Elvis:  You cannot get it yet.  This may not be available until May 2011 (the current scuttlebutt points to this timeline) and it will only work on a Boxee BOX.  You are using the Boxee software for PC/MAC/*NIX if you are downloading from the Boxee website -- the box retrieves downloads directly into itself including firmware updates.

Apr-09 2011 03:10 pm.
Elvis Travancic
boxee

OK, a quick question here, where do I get Boxee version 1.1.1.0.18xxx - the latest I can download from Boxee site is 0.9.23.15885?

I tried this with version 0.9.23.15885 and it does not work.

Apr-07 2011 10:58 am.