Knowledge Base/Boxee PC Software/Setting Up Boxee

Correctly naming local media files

marcel hass
posted this on Jun-23 2009 05:41 am

After setting up your media sources Boxee will start to retrieve artwork and information, based on how your media files are named.
There is a specific way you must name your movie files and your TV shows and episodes for the function to work correctly.

For correct names of Movies and TV shows, please refer to


It is recommended to place a single movie inside a directory.

Boxee currently supports the following naming convention for movies:


  • Die.Hard.avi
  • Toy.Story.2.avi

It is recommended that you add the movie's release year for greater accuracy, especially when dealing with remakes.


  • The.Day.the.Earth.Stood.Still.(1951).avi
  • The.Day.the.Earth.Stood.Still.(2008).avi

For multi-part movie both part# and cd# are supported.

  • Seven.Pounds.cd1.avi
  • Seven.Pounds.cd2.avi
  • The.Simpsons.Movie.part1.avi
  • The.Simpsons.Movie.part2.avi

All parameters can be used in conjunction - Title.(Year).part.extension

  • The.Stepford.Wives.(2004).part1.avi
  • The.Stepford.Wives.(2004).part2.avi
  • The.Stepford.Wives.(1975).cd1.avi
  • The.Stepford.Wives.(1975).cd2.avi

TV Shows

TV Shows' file names are usually consisted of the show's name, the season (usually indicated by the letter "S", or just the number), the episode (usually indicated by the letter "E", or just the number), the episode's title, and some more info regarding the quality and source of the file.

Boxee currently supports the following types of naming conventions for tv shows. (double digits are required: S#E# will not work.)

  • The.Sopranos.S02E01.avi
  • Entourage.S05E01.avi

  • How.I.Met.Your.Mother.1x01.Pilot.avi
  • The.Office.02×02.stuff.avi

Please note: Adding the series' release year in the file will help resolve remakes and TV shows with similar names
(please refer to to find the correct release year of the show)


Extra/Special episodes:

Season number should be '00' , episode number should be 01-##.
The episode number should be assigned according to listings.

South Park extra episode called "The Spirit of Christmas (santa vs frosty)"
should be named South.Park.S00E02


With music, the most important issue is the id3 tags.

These tags hold all the information such as album name, artist, year, genre and even artwork. Whatever is there, will be presented in Boxee, so be sure to include as much info as possible in your id3 tags.

If you do not want to keep the artwork as part of the id3 tag, you can also put a picture file of the artwork in the relevant folder, and name the file 'folder.jpg'.


Renaming Files

You can always use a third party application to help you rename the files.

There are also quite a few applications out there, that allow you to edit the ID3 tags of your mp3 collection. Most media players such as iTunes or Windows Media Player, also allow you to edit those tags, but you can also Google for some dedicated ID3 editors.

Topic is closed for comments